Skip to main content

Agents API

List and inspect AI agents in your spaces.

List Agents​

GET /v1/agents

Scope required: agents

Response​

{
  "agents": [
    {
      "id": "agent_soporte",
      "name": "Soporte Técnico",
      "summary": "Handles technical support tickets and troubleshooting",
      "is_primary": true,
      "group_id": "group_main",
      "space_code": "soporte"
    }
  ]
}

Agent Detail​

GET /v1/agents/:id

Returns agent details including assigned actions and knowledge files.

Response​

{
  "id": "agent_soporte",
  "name": "Soporte Técnico",
  "summary": "Handles technical support",
  "is_primary": true,
  "actions": [
    { "id": "action_jira", "name": "Create Jira Ticket", "description": "Creates a support ticket in Jira" }
  ],
  "knowledge_files": [
    { "id": "doc_faq", "filename": "faq.txt", "content_summary": "Frequently asked questions", "status": "ready" }
  ]
}