Skip to main content
PUT
Update shared identity
La identidad compartida es la persona del agente. Todas sus tareas hablan con este nombre, voz, idioma e instrucciones, también mientras el agente decide qué tarea debe responder.
  • Una tarea que tiene su propio idioma lo mantiene.
  • En channel_prompts, las instrucciones del agente para un canal van primero, y las instrucciones de una tarea para ese mismo canal se agregan después.
  • Es un reemplazo completo, así que envía todos los campos. Para cambiar solo uno, primero lee los valores actuales con Consultar configuración.

Autorizaciones

X-API-Key
string
header
requerido

API key for authentication. Keys are prefixed with nxr_live_.

Parámetros de ruta

id
string<uuid>
requerido

Agent ID (master_workflow in the API). A malformed ID returns 400 invalid_group_id.

Cuerpo

application/json
name
string
requerido
Required string length: 1 - 120
voice_id
string
requerido
Required string length: 1 - 255
language
enum<string>
requerido
Opciones disponibles:
es-CL,
es-MX,
es-PE,
es-CO,
es-AR,
es-US,
en-US,
en-AU,
ko-KR,
pt-BR,
fr-FR
identity_prompt
string
requerido
Required string length: 1 - 8000
channel_prompts
object
requerido

Extra instructions per channel, up to 8,000 characters each. Send {} for none.

confirm
enum<boolean>
requerido

Must be true.

Opciones disponibles:
true

Respuesta

Saved identity.

agent_group_id
string<uuid>
requerido
identity
object | null
requerido

The agent's shared identity: the name, voice, language, and instructions all of its tasks speak with, including while the agent works out which task should answer. When the agent has no complete identity of its own, the values shown come from the default task.

Última modificación el 28 de septiembre de 2026