> ## Documentation Index
> Fetch the complete documentation index at: https://docs.getnexor.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Update shared identity

> Replace the name, voice, language, and instructions all tasks of an agent speak with. Requires confirm: true.

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](/docs/en/api/inbound-router/get-inbound-router) first.

| Field | Rules |
| - | - |
| `name` | 1 to 120 characters. |
| `voice_id` | A voice from [List voices](/docs/en/api/workflows/get-workflows-by-id-voices). |
| `language` | `es-CL`, `es-MX`, `es-PE`, `es-CO`, `es-AR`, `es-US`, `en-US`, `en-AU`, `ko-KR`, `pt-BR`, or `fr-FR`. |
| `identity_prompt` | 1 to 8,000 characters. |
| `channel_prompts` | Keys `whatsapp`, `sms`, `imessage`, `unsupervised-whatsapp` (personal WhatsApp line), `email`, `webchat`, `instagram`, `messenger`, and `retell` for phone calls. Up to 8,000 characters each. Empty values are dropped. Send an empty object for none. |


## API Specification

The full API specification for this endpoint is available in the [documentation index](https://docs.getnexor.ai/llms.txt).