List use cases metadata

Discover use cases through a paginated metadata index.

GET/api/capabilities/use-cases

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.
lifecycle · optional
string
Optional lifecycle metadata filter.

Name	Type	Description
q	string	Text query over metadata.
limit	integer	1–500; default 500.
offset	integer	Non-negative offset; default 0.
lifecycle	string	Optional lifecycle metadata filter.

Errors

Status	Meaning
422	Invalid query type or pagination bounds.

Example

bash

curl "https://app.autotouch.ai/api/capabilities/use-cases"

Response example

json

{
  "schema_version": "product_use_case_index.v1",
  "use_cases": {
    "index": [],
    "count": 0,
    "total": 0,
    "offset": 0,
    "limit": 500
  }
}