---
title: "Search the catalog — find operations and workflows by natural language intent"
method: GET
path: "/search"
tags: ["search"]
---

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

`GET /search`

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.

## Query parameters

- `q` string, required — Search query, e.g. "send an email" or "create payment"
- `n` integer — Number of results to return

## Response `200`

Successful Response

- SearchResult[]
  - `type` string, required — Result type: 'operation' for API endpoints, 'workflow' for multi-step Arazzo workflows
  - `id` string, required — Capability ID in METHOD/host/path format
  - `slug` string, nullable — Workflow slug (workflows only) — used as path segment in POST /workflows/{slug}
  - `summary` string, nullable — Short description of what this capability does
  - `description` string, nullable — Detailed description from the OpenAPI operation or Arazzo workflow
  - `score` number, required — BM25 relevance score (0.0-1.0) — higher is more relevant to the search query
  - `involved_apis` string[] — List of upstream API hosts involved in this capability (for workflows, may list multiple)

## Other responses

- `422` — Validation Error

## Changes

- **2026-04-13** `76e8f6063728` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/jentic/apis/jentic-control-plane-api/changes/search/get.md)

---

[API](https://skmtc.dev/jentic/apis/jentic-control-plane-api.md) · [All operations](https://skmtc.dev/jentic/apis/jentic-control-plane-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/jentic/jentic-control-plane-api/revisions/bd463fcefb14/schema)