Documentation
API Reference

Agents API

Create, configure, and retrieve agent instances programmatically.

List agents#

Retrieve a list of active agents configured in your workspace:

GET/v1/agents

Request

BASH
curl -H "Authorization: Bearer tc_live_key" \
  https://api.trained.chat/v1/agents

Response

JSON
{
  "agents": [
    {
      "id": "agent_941a",
      "role": "Customer Support",
      "status": "deployed",
      "created_at": "2026-06-01T12:00:00Z"
    }
  ]
}