v18

latestOpenAPI 3.1.0raw.githubusercontent.com2026-07-2112360218.7 KB
Search

Search Registry Entities

Searches prompts, skills, and tools across every project the requester can view. The server retrieves lexical and semantic candidates from the natural-language query, reranks them, and reapplies project access before returning common entity metadata.

get/v1/search

Query parameters

qstring required
Example:Find something that handles customer refunds

Natural-language text describing the desired prompt, skill, or tool. Can optionally include an inline type filter prefix or suffix (e.g., type:prompt refund or refund type:tool) which restricts results to the specified entity type. If an invalid type filter (e.g., type:unknown) is provided in the query string, a 400 Bad Request is returned. Provider names, modes, scores, and embedding vectors are internal and cannot be supplied by clients.

type'prompt' | 'skill' | 'tool'
Example:prompt

Restricts the search to one entity type. When omitted, all registered entity types are searched together.

Response

Ranked registry search results

Example response

{
  "results": [
    {
      "type": "prompt"
    }
  ]
}