List models

Workspace ID.

Maximum number of results to return

Pagination cursor from previous response

Filter by a prefix of the model's display name, external id, or id (case-insensitive). A model's external id is the form used in modelConfig.modelId, so a caller holding that can narrow the list by it.

Free-form search query

Filter by model state

Filter to models provisioned on a specific AI provider key. Accepts the key's id or an "external_id:"-prefixed slug.

Filter models to only ones assigned to an active agent variation/agent. Draft agents count as assigned; archived agents do not. Assignment does not imply recent traffic — see ModelInfo.last_used_at for that.

Filters by metadata labels. Comma-separated key=value pairs, e.g. "env=prod,team=ai". A resource matches only if every pair matches exactly (AND semantics).

Sort order for results (asc or desc by creation time)

When true, populate each item's info (e.g. the AI provider), at the cost of extra lookups.