Update Persona - Vaani Backend API

curl -X PATCH https://api.vaanivoice.ai/api/agent/7ec4155e-0e62-440a-b983-5974f7697854/persona \
  -H "X-API-Key: vaani_<your_key>" \
  -H "Content-Type: application/json" \
  -d '{
    "identity": {
      "system_prompt": "You are a helpful customer service agent.",
      "greeting_message": {
        "agent_message": "Hi! How can I help you today?",
        "agent_speech_delay": 1,
        "interruptible": true
      }
    },
    "senses_capabilities": {
      "language": "en",
      "brain": {
        "llm": {
          "primary": {
            "provider": "openai",
            "model": "gpt-4o",
            "parameters": { "temperature": 0.7 }
          }
        }
      }
    }
  }'

{
  "success": true,
  "message": "Persona section updated successfully"
}

PATCH

api

agent

{agent_id}

persona

curl -X PATCH https://api.vaanivoice.ai/api/agent/7ec4155e-0e62-440a-b983-5974f7697854/persona \
  -H "X-API-Key: vaani_<your_key>" \
  -H "Content-Type: application/json" \
  -d '{
    "identity": {
      "system_prompt": "You are a helpful customer service agent.",
      "greeting_message": {
        "agent_message": "Hi! How can I help you today?",
        "agent_speech_delay": 1,
        "interruptible": true
      }
    },
    "senses_capabilities": {
      "language": "en",
      "brain": {
        "llm": {
          "primary": {
            "provider": "openai",
            "model": "gpt-4o",
            "parameters": { "temperature": 0.7 }
          }
        }
      }
    }
  }'

{
  "success": true,
  "message": "Persona section updated successfully"
}

Update Agent Persona

Partially update the persona section of an agent. Only the fields you include are deep-merged into the existing configuration; omitted fields are left unchanged. The persona section controls the agent’s identity (system prompt, greeting), AI providers (STT / LLM / TTS), actions, memories, and metadata.

Path Parameters

agent_id

string

required

UUID of the agent to update.

Body Parameters

identity

object

Core identity settings.

Show identity fields

system_prompt

string

The main system prompt that drives the agent’s behaviour.

personality

object

Key-value map of personality traits (e.g. {"tone": "friendly"}).

greeting_message

object

Controls the opening message spoken by the agent.

Show greeting_message fields

agent_message

string

Text the agent says at the start of the call.

agent_speech_delay

integer

Delay (seconds, 0–60) before the agent speaks.

user_speech_delay

integer

Silence gap (seconds, 0–60) after user stops talking.

interruptible

boolean

Whether the greeting can be interrupted by the user.

let_user_speak_first

boolean

If true, the agent waits for the user to speak before greeting.

senses_capabilities

object

AI provider configuration for speech-to-text, LLM, and text-to-speech.

Show senses_capabilities fields

language

string

Primary language code (e.g. "en", "hi").

auto_detect

boolean

Enable automatic language detection.

ears

object

STT (speech-to-text) configuration.

Show ears.stt fields

primary.provider

string

STT provider name.

primary.model

string

STT model identifier.

primary.language

string

Language hint for STT.

primary.keywords

array

Keywords to boost recognition accuracy.

fallback

object

Fallback STT provider (same shape as primary).

brain

object

LLM configuration.

Show brain.llm fields

primary.provider

string

LLM provider name (e.g. "openai").

primary.model

string

Model identifier (e.g. "gpt-4o").

primary.parameters.temperature

number

Sampling temperature (0–1).

primary.parameters.top_p

number

Top-p sampling (0–1).

primary.parameters.max_tokens

integer

Max tokens (50–10000).

auto_detect_llm

boolean

Auto-select the best LLM for the detected language.

fallback

object

Fallback LLM provider (same shape as primary).

mouth

object

TTS (text-to-speech) configuration.

Show mouth.tts fields

primary.provider

string

TTS provider name (e.g. "elevenlabs").

primary.model

string

TTS model identifier.

primary.voice_id

string

Voice ID.

primary.voice_name

string

Voice name.

primary.config

object

Provider-specific config key-value pairs.

word_pronunciation_pairs

object

Map of words to their preferred pronunciation.

fallback

object

Fallback TTS provider (same shape as primary).

actions

object

Custom actions the agent can take during a call (provider-specific shape).

memories

object

Memory configuration for the agent (provider-specific shape).

metadata

object

Arbitrary metadata key-value pairs attached to the persona.

Request Example

curl -X PATCH https://api.vaanivoice.ai/api/agent/7ec4155e-0e62-440a-b983-5974f7697854/persona \
  -H "X-API-Key: vaani_<your_key>" \
  -H "Content-Type: application/json" \
  -d '{
    "identity": {
      "system_prompt": "You are a helpful customer service agent.",
      "greeting_message": {
        "agent_message": "Hi! How can I help you today?",
        "agent_speech_delay": 1,
        "interruptible": true
      }
    },
    "senses_capabilities": {
      "language": "en",
      "brain": {
        "llm": {
          "primary": {
            "provider": "openai",
            "model": "gpt-4o",
            "parameters": { "temperature": 0.7 }
          }
        }
      }
    }
  }'

Response

{
  "success": true,
  "message": "Persona section updated successfully"
}

Create Agent Update Training

​Update Agent Persona

​Path Parameters

​Body Parameters

​Request Example

​Response

Update Agent Persona

Path Parameters

Body Parameters

Request Example

Response