List Configs

Catalog prerequisites

This operates on the database-backed component catalog configured on AgentOS, not on the in-code agents, teams or workflows lists. It requires a supported synchronous BaseDb adapter with component methods.

Published components can be readable across scoped owners, while writes remain owner-scoped; a visible foreign or shared row can still reject a write with 403. Draft versions require preview access. Saving configuration does not validate model credentials, run tools or deploy a service.

Version listing

include_config defaults to true. Keep that default on current main: the SQLite path with include_config=false omits a field required by the response model and returns 500. If you need only version metadata, discard configuration bodies in your client after receiving the response. Draft versions are filtered by preview access; publication visibility does not grant access to every draft.

GET/components/{component_id}/configs

List all configs for a component.

Authorization

HTTPBearer
AuthorizationBearer <token>

In: header

Path Parameters

component_id*Component Id

Component ID

Query Parameters

include_config?Include Config

Include full config blob

Defaulttrue

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl --request GET 'https://example.com/components/string/configs'
[  {    "component_id": "string",    "version": 0,    "label": "string",    "stage": "string",    "config": {},    "notes": "string",    "created_at": 0,    "updated_at": 0  }]