List operations metadata

Discover operations through a paginated metadata index.

GET/api/capabilities/operations

HTTP referenceScope None (public)Updated September 27, 2026

This page documents the canonical HTTP contract for this endpoint.

These metadata routes are public and do not process authentication credentials. Public metadata does not grant execution authority. Operation, CLI and HTTP support are distinct. See capability discovery for the catalog relationships.

The abridged response example illustrates an empty matching index; metadata such as detail links may also be returned. Discover identifiers here before requesting a detail. Fields and supported filter values come from the metadata itself.

Query parameters

q · optional
string
Text query over metadata.
limit · optional
integer
1–500; default 500.
offset · optional
integer
Non-negative offset; default 0.
surface · optional
string
Optional surface metadata filter.
cli_status · optional
string
Optional cli status metadata filter.
cli_available · optional
boolean
Optional cli available metadata filter.
approval_required · optional
boolean
Optional approval required metadata filter.
executable_only · optional
boolean
Default false. Filter for callable Command Center support; this is not an HTTP API eligibility filter.

Name	Type	Description
q	string	Text query over metadata.
limit	integer	1–500; default 500.
offset	integer	Non-negative offset; default 0.
surface	string	Optional surface metadata filter.
cli_status	string	Optional cli status metadata filter.
cli_available	boolean	Optional cli available metadata filter.
approval_required	boolean	Optional approval required metadata filter.
executable_only	boolean	Default false. Filter for callable Command Center support; this is not an HTTP API eligibility filter.

Errors

Status	Meaning
422	Invalid query type or pagination bounds.

Example

bash

curl "https://app.autotouch.ai/api/capabilities/operations"

Response example

json

{
  "schema_version": "product_operation_index.v1",
  "operations": {
    "index": [],
    "count": 0,
    "total": 0,
    "offset": 0,
    "limit": 500
  },
  "filters": {
    "q": null,
    "surface": null,
    "cli_status": null,
    "cli_available": null,
    "approval_required": null,
    "executable_only": false
  }
}