Update shared identity
Replace the name, voice, language, and instructions all tasks of an agent speak with. Requires confirm: true.
PUT
Update shared identity
The shared identity is the agent’s persona. All of its tasks speak with this name, voice, language, and instructions, including while the agent works out which task should answer.
- A task that has its own language keeps it.
- In
channel_prompts, the agent’s instructions for a channel come first, and a task’s instructions for the same channel are added after them. - This is a full replacement, so send every field. To change only one, read the current values with Get settings first.
Customer content limit
The shared identity counts toward each member task’s 20,000 customer tokens. Nexor’s internal instructions are excluded. The API checks both the shared identity alone and each task with the proposed identity. If either exceeds the limit, it returns422 customer_prompt_too_large with tokens, limit, and customer. The identity change is not saved.Authorizations
Path Parameters
Body
application/json
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.
Available options:
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 Response
Saved identity.
Last modified on November 5, 2026
Update shared identity