Saltar al contenido principal
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.

Límite de contenido del cliente

La identidad compartida cuenta dentro de los 20.000 tokens del cliente de cada tarea del agente. Las instrucciones internas de Nexor quedan fuera de este cupo. La API revisa tanto la identidad compartida por sí sola como cada tarea con la identidad propuesta. Si alguna supera el límite, devuelve 422 customer_prompt_too_large con tokens, limit y customer. El cambio de identidad no se guarda.

Autorizaciones

X-API-Key
string
header
requerido

API key for authentication. Keys are prefixed with nxr_live_. To work inside a sub-account with a main account key, also send the optional X-Nexor-Sub-Account-Id header.

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,
ar-AE,
zh-CN,
vi-VN,
th-TH
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
secondary_languages
enum<string>[]

Other languages the agent can switch a lead to. One per language, never the agent's own language. Omit it to keep the saved list; send [] to clear it.

Opciones disponibles:
es-CL,
es-MX,
es-PE,
es-CO,
es-AR,
es-US,
en-US,
en-AU,
ko-KR,
pt-BR,
fr-FR,
ar-AE,
zh-CN,
vi-VN,
th-TH

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 5 de noviembre de 2026