Skip to main content
GET
/
assets
/
agents
List Agents
curl --request GET \
  --url https://api.example.com/assets/agents \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "resource_uri": "<string>",
      "name": "<string>",
      "status": "<string>",
      "lifecycle_stage": "<string>",
      "health_status": "<string>",
      "verification_status": "<string>",
      "current_version": 123,
      "project_id": "<string>",
      "created_by": "<string>",
      "owner_id": "<string>",
      "created_at": "2023-11-07T05:31:56Z",
      "description": "<string>",
      "a2a_protocol_version": "<string>",
      "tags": []
    }
  ],
  "pagination": {
    "page": 2,
    "limit": 50,
    "total_items": 1,
    "total_pages": 1,
    "next_page": 123,
    "prev_page": 123
  }
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

​
X-Project-ID
string | null

Query Parameters

​
page
integer
default:1

Page number (starts at 1)

Required range: x >= 1
​
limit
integer
default:20

Items per page

Required range: 1 <= x <= 100
​
status
string | null

Filter by admin status

​
lifecycle_stage
string | null

Filter by lifecycle stage

​
tags
string | null

Filter by tags (comma-separated)

​
a2a_protocol_version
string | null

Filter by A2A protocol version

​
sort
string | null

Sort: field:order,...

​
created_by
string | null

Filter by creator (e.g., 'user:alice')

​
owner_id
string | null
deprecated

Deprecated: use created_by instead. Will be removed in a future release.

Response

Successful Response

Paginated list response.

​
data
AgentSummary · object[]
required
​
pagination
Pagination · object
required

Pagination metadata for list responses.