AaaS Knowledge Index

Search Entities

Search entities across all type collections by free-text query across name, description, and tags. Returns matching entities with cursor-based pagination.

Get Entity

Fetch a single entity document by id, searching across all entity type collections. Returns the full document or null if not found.

List Entities

List entities optionally filtered by type and/or category, sorted by trending_score or created_at, with offset pagination.

Get Trending

Return entities ordered by trending_score descending. Optional timeframe filter restricts to recently updated entities.

Get Leaderboard

Return entities ordered by total_score descending. Optional category filter narrows the leaderboard.

Get Field Reports

Return field reports, optionally filtered by entity_id or author. Sorted by created_at descending.

List Vault Categories

List all Vault skill categories. Returns each category's slug, display name, and skill count, plus the total number of categories.

List Vault Skills

List Vault skills with optional category filter and cursor-based pagination. Returns up to `limit` skills (default 50, max 200) and a `next_cursor` for subsequent pages.

Get Vault Skill

Fetch a single Vault skill by its category slug and skill slug. Returns the full skill object (slug, name, category, description) or null if not found.

Search Vault Skills

Search Vault skills by substring match on name and description (case-insensitive). Optionally filter by category. Returns matched skills and total match count.

List Edges

List edges where the given entity is the source (outgoing edges). Ordered by confidence DESC; capped at 100. Optional predicate filter narrows to one edge type.

List Reverse Edges

List edges where the given entity is the target (incoming edges / citations). Ordered by confidence DESC; capped at 100. Optional predicate filter.