Update Avatar

Update an existing avatar’s configuration including name, provider, model, voice, and prompt.

You can update the following fields:

• name: Change the avatar’s display name (must be unique per account)
• providerId, model, voice: Switch to different AI provider/model/voice
• firstMessage, prompt: Modify avatar behavior and initial greeting

Note: The avatar’s source media (url) cannot be changed after creation.

POST /api/open/v1/avatar/update

Update Avatar

cURL

curl --request POST \
  --url https://api.navtalk.ai/api/open/v1/avatar/update \
  --header 'Content-Type: application/json' \
  --header 'license: <api-key>' \
  --data '
{
  "id": "fbc269dcd0a738cf8e5e0f465671303c",
  "name": "my-updated-avatar",
  "providerId": "b92a28fb2ea737457c7f13ba554759c0",
  "model": "agent_3201khcbet2vf349gpmtfg83q0hy",
  "voice": "CwhRBWXzGAHq8TQ4Fs17",
  "firstMessage": "Hello! How may I assist you?",
  "prompt": "You are a friendly customer service assistant."
}
'

200

Example

{
  "code": 200,
  "message": "SUCCESS",
  "data": "Avatar updated successfully"
}

Authorizations

license · string · header · required

NavTalk API license key (e.g. sk_navtalk_...)

Body

application/json

id · string · required

The avatar ID to update.

Example:

"fbc269dcd0a738cf8e5e0f465671303c"

name · string · required

Display name for the avatar. Must be unique per account.

Example:

"my-updated-avatar"

providerId · string · required

The provider ID to use (obtained from /provider/list).

Example:

"b92a28fb2ea737457c7f13ba554759c0"

model · string · required

The model key to use (obtained from /model/list). For ElevenLabs agents, see ElevenLabs Agents Quickstart.

Example:

"agent_3201khcbet2vf349gpmtfg83q0hy"

voice · string · required

The voice key to use (obtained from /voice/list).

Example:

"CwhRBWXzGAHq8TQ4Fs17"

firstMessage · string

Optional opening message the avatar says at the start of a conversation.

Example:

"Hello! How may I assist you?"

prompt · string

Optional system prompt that controls the avatar's behavior and personality.

Example:

"You are a friendly customer service assistant."

Response

200

application/json

Avatar updated successfully

code · integer

Example:

200

message · string

Example:

"SUCCESS"

data · string

Example:

"Avatar deleted successfully"