search

Search the catalog — find operations and workflows by natural language intent

BM25 search over all registered API operations, Arazzo workflows, and the Jentic public API catalog.

Returns id, summary, description (≤3 sentences), type, score, and _links.

  • source: "local" — operation or workflow in your local registry
  • source: "catalog" — API available from the Jentic public catalog; add credentials to use

_links.inspect → GET /inspect/{id} for full schema and auth detail. _links.execute → broker URL to call directly once ready. Typical flow: search → inspect → execute.

get/search

Query parameters

qstring required

Search query, e.g. "send an email" or "create payment"

Search query, e.g. "send an email" or "create payment"

ninteger

Number of results to return

Number of results to return

Response

Successful Response

typestring required

Result type: 'operation' for API endpoints, 'workflow' for multi-step Arazzo workflows

idstring required

Capability ID in METHOD/host/path format

slugstring nullable

Workflow slug (workflows only) — used as path segment in POST /workflows/{slug}

summarystring nullable

Short description of what this capability does

descriptionstring nullable

Detailed description from the OpenAPI operation or Arazzo workflow

scorenumber required

BM25 relevance score (0.0-1.0) — higher is more relevant to the search query

involved_apisstring[]

List of upstream API hosts involved in this capability (for workflows, may list multiple)

Example response

[
  {
    "type": "operation",
    "id": "GET/api.github.com/repos/{owner}/{repo}/issues",
    "slug": "github-list-issues",
    "summary": "List repository issues",
    "description": "List issues in a repository",
    "score": 0.85,
    "involved_apis": [
      "api.github.com"
    ]
  }
]

Changes