curl https://chatatp-agent-builder-backend.onrender.com/v1/agents/ \
-H "Authorization: Bearer $CHATATP_API_KEY"
{
"data": [
{
"id": 7,
"name": "Support Agent",
"description": "Answers support questions",
"status": "active",
"avatar_url": "https://cdn.example.com/agent.png",
"capabilities": {
"persistent_conversations": true,
"streaming": true,
"tool_activity": true
},
"created_at": "2026-01-12T10:00:00Z",
"updated_at": "2026-06-01T14:22:00Z"
}
]
}
Agents
List agents
List all agents accessible to the current API key
GET
/
v1
/
agents
/
curl https://chatatp-agent-builder-backend.onrender.com/v1/agents/ \
-H "Authorization: Bearer $CHATATP_API_KEY"
{
"data": [
{
"id": 7,
"name": "Support Agent",
"description": "Answers support questions",
"status": "active",
"avatar_url": "https://cdn.example.com/agent.png",
"capabilities": {
"persistent_conversations": true,
"streaming": true,
"tool_activity": true
},
"created_at": "2026-01-12T10:00:00Z",
"updated_at": "2026-06-01T14:22:00Z"
}
]
}
Returns every agent the current Developer API key can access.
Agent[]
required
Page of agents.
integer
required
Agent ID.
string
required
Display name.
string
Short description.
string
active or inactive.string
Avatar image URL.
object
Feature flags for the agent.
boolean
Supports persistent conversations.
boolean
Supports streaming responses.
boolean
Can execute tools.
string
ISO 8601 timestamp.
string
ISO 8601 timestamp.
curl https://chatatp-agent-builder-backend.onrender.com/v1/agents/ \
-H "Authorization: Bearer $CHATATP_API_KEY"
{
"data": [
{
"id": 7,
"name": "Support Agent",
"description": "Answers support questions",
"status": "active",
"avatar_url": "https://cdn.example.com/agent.png",
"capabilities": {
"persistent_conversations": true,
"streaming": true,
"tool_activity": true
},
"created_at": "2026-01-12T10:00:00Z",
"updated_at": "2026-06-01T14:22:00Z"
}
]
}
SDK
const page = await client.agents.list();
for await (const agent of page) {
console.log(agent.id, agent.name);
}
page = await client.agents.list()
for agent in page:
print(agent.id, agent.name)