Skip to main content
GET
List procedure families
Returns one page of the procedure families the caller may read, ordered by procedureId, each described by its highest visible active version. Follow meta.nextCursor while meta.hasMore is true; a cursor the server did not issue, including a numeric offset, is 400. See Procedure catalog.

Filters

The Console catalog’s filters, each optional; they apply to each family’s head before paging, so the cursor stays valid:
  • search: case-insensitive text matched against the name, procedureId, description, and the vendor and connection names of the family’s bindings.
  • source (repeatable): builtin, workspace or marketplace.
  • runtime (repeatable): python or node.
  • vendor (repeatable): vendor keys; __unassigned matches families with no vendor.
  • agentTool: true or false, whether the head is exposed as an agent tool.
search and agentTool may each appear once; agentTool other than true or false is 400 bad_request.

Authorizations

Authorization
string
header
required

An External App: the JWT it obtains from POST /oauth/token with OAuth2 client_credentials. Pass as Authorization: Bearer <jwt>. An app's static companion key also authenticates as the app, but is deprecated and is not protected by Idempotency-Key.

Query Parameters

limit
integer
default:50

Families per page, 1 to 100. Defaults to 50; a larger value is 400 too_big.

Required range: 1 <= x <= 100
cursor
string

The opaque meta.nextCursor from the previous page.

Minimum string length: 1

Case-insensitive text matched against the name, procedureId, description, and the vendor and connection names of the family's bindings.

source
string[]

Repeatable. Only these sources: builtin, workspace, marketplace.

Minimum string length: 1
runtime
string[]

Repeatable. Only these runtimes: python, node.

Minimum string length: 1
vendor
string[]

Repeatable. Only families bound to these vendor keys; __unassigned matches families with no vendor.

Minimum string length: 1
agentTool
boolean

Only families whose head is (true) or is not (false) exposed as an agent tool.

Response

One page of procedure families

data
object[]
required
meta
object
required

A list page's continuation. While hasMore is true, nextCursor is a string: pass it as cursor for the next page. hasMore: false ends the list; with truncated: true, more exist past what this list reads, and no cursor reaches them.