List Components

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.

Catalog listing

This lists visible database components, with pagination and optional component_type filtering. Registered code IDs are excluded from the corresponding catalog listing; without a type filter, the exclusion uses the registry's combined ID set. Use the agent, team and workflow discovery endpoints for their served runtime inventory.

include_deleted=true includes archived rows marked by deleted_at. Returned IDs are the identifiers to use for version and lifecycle requests.

GET/components

Retrieve a paginated list of components with optional filtering by type.

Authorization

HTTPBearer
AuthorizationBearer <token>

In: header

Query Parameters

component_type?|

Filter by type: agent, team, workflow

page?Page

Page number

Range1 <= value
Default1
limit?Limit

Items per page

Range1 <= value <= 100
Default20
include_deleted?Include Deleted

Also list archived (soft-deleted) components, marked by a deleted_at timestamp

Defaultfalse

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl --request GET 'https://example.com/components'
{  "data": [    {      "component_id": "string",      "component_type": "agent",      "name": "string",      "user_id": "string",      "description": "string",      "current_version": 0,      "metadata": {},      "created_at": 0,      "updated_at": 0,      "deleted_at": 0    }  ],  "meta": {    "page": 0,    "limit": 20,    "total_pages": 0,    "total_count": 0,    "search_time_ms": 0  }}