Skip to main content
PATCH
/
v1
/
agents
/
{agentId}
Actualizar atributos configurables del agente
curl --request PATCH \
  --url https://agents.studio.getsupervisor.ai/v1/agents/{agentId} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'x-workspace-id: <x-workspace-id>' \
  --data '
{
  "name": "Soporte Voz Latam",
  "status": "active",
  "metadata": {
    "statusReason": "SLA firmado"
  }
}
'
{
  "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": [],
  "tools": [],
  "createdAt": "2025-09-20T18:22:04.012Z",
  "updatedAt": "2025-10-09T09:31:45.271Z",
  "metadata": {
    "statusReason": "Campaña Q4"
  }
}

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

Body

application/json
​
name
string
​
status
enum<string>
Available options:
inactive,
training,
active,
archived
​
description
string | null
​
toneId
string<uuid> | null
​
messageStyleId
string<uuid> | null
​
tags
string<uuid>[]
​
debounceDelayMs
integer | null
Required range: x >= 0
​
ownerUserId
string<uuid> | null
​
metadata
object

Response

Agente actualizado

​
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