Skip to main content
GET
/
v1
/
agents
/
{agentId}
Obtener detalle de un agente
curl --request GET \
  --url https://agents.studio.getsupervisor.ai/v1/agents/{agentId} \
  --header 'Authorization: Bearer <token>' \
  --header 'x-workspace-id: <x-workspace-id>'
{
  "agentId": "5769e110-7267-4cf7-a3ca-2d06e8fffbb3",
  "workspaceId": "a44bb95e-9f01-4d19-8b62-1f6f2b8e8363",
  "name": "Soporte Voz Latam",
  "agentType": "voice",
  "status": "active",
  "versionId": "b8f60a6d-4c3a-4b9f-8cf3-56ad71d2f2bf",
  "knowledgeBaseIds": [
    "4aa9f55c-dc5a-4a8f-87a0-2871a5b5e1e1"
  ],
  "tools": [
    {
      "identifier": "zendesk_tickets",
      "displayName": "Zendesk Tickets",
      "enabled": true
    }
  ],
  "voiceConfig": {
    "voiceId": "laura-es",
    "webhookUrl": "https://hooks.ai/workspace/agents"
  },
  "createdAt": "2025-09-20T18:22:04.012Z",
  "updatedAt": "2025-10-03T10:15:11.004Z",
  "metadata": {
    "projectCode": "CX-OPS-001",
    "ownerUserId": "0a3c8cf2-6b54-4e89-8d36-7e67c77dfba5"
  }
}

Authorizations

​
Authorization
string
header
required

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

Headers

​
x-workspace-id
string<uuid>
required

Identificador del workspace multi-tenant.

Path Parameters

​
agentId
string<uuid>
required

Identificador del agente

Response

Agente encontrado

​
agentId
string<uuid>
required
​
name
string
required
​
agentType
enum<string>
required
Available options:
chat,
voice
​
workspaceId
string<uuid>
required
​
status
enum<string>
required
Available options:
inactive,
training,
active,
archived
​
createdAt
string<date-time>
required
​
updatedAt
string<date-time>
required
​
versionId
string<uuid>
​
description
string | null
​
avatarUrl
string<uri> | null

URL pública opcional utilizada para representar al agente.

​
debounceDelayMs
integer | null

Delay opcional antes de enviar respuestas (milisegundos).

Required range: x >= 0
​
toneId
string<uuid> | null
​
messageStyleId
string<uuid> | null
​
ownerUserId
string<uuid> | null
​
knowledgeBaseIds
string<uuid>[]

Identificadores de knowledge bases asociadas.

​
tags
string<uuid>[]

Tags de negocio asignados al agente. Se administran mediante /v1/agents/{agentId}/tags.

​
tools
object[]

Tools habilitadas para el agente.

​
voiceConfig
object

Configuración de voz activa cuando el agente es de tipo voice.

​
metadata
object