Skip to main content
GET
/
agents
[
  {
    "id": "<string>",
    "name": "<string>",
    "description": "<string>",
    "status": "Unknown",
    "acp_type": "sync",
    "status_reason": "<string>",
    "created_at": "2023-11-07T05:31:56Z",
    "updated_at": "2023-11-07T05:31:56Z",
    "registration_metadata": {},
    "registered_at": "2023-11-07T05:31:56Z"
  }
]

Query Parameters

​
task_id
string | null

Task ID

​
limit
integer
default:50

Limit

Required range: x >= 1
​
page_number
integer
default:1

Page number

Required range: x >= 1

Response

Successful Response

​
id
string
required

The unique identifier of the agent.

​
name
string
required

The unique name of the agent.

​
description
string
required

The description of the action.

​
acp_type
enum<string>
required

The type of the ACP Server (Either sync or agentic)

Available options:
sync,
agentic
​
created_at
string<date-time>
required

The timestamp when the agent was created

​
updated_at
string<date-time>
required

The timestamp when the agent was last updated

​
status
enum<string>

The status of the action, indicating if it's building, ready, failed, etc.

Available options:
Ready,
Failed,
Unknown,
Deleted
​
status_reason
string | null

The reason for the status of the action.

​
registration_metadata
object | null

The metadata for the agent's registration.

​
registered_at
string<date-time> | null

The timestamp when the agent was last registered