Skip to main content
PATCH

Update Agent Persona

Partially update the persona section of an agent. Fields you leave out are left unchanged, but see the note below on which fields are merged and which are replaced.
Not every field is merged. Only the AI provider blocks under senses_capabilities (ears, brain, mouth) are deep-merged. Dictionaries and lists such as metadata, word_pronunciation_pairs (under senses_capabilities.mouth.tts) and the actions function list are replaced as a whole by what you send, so always send the complete value you want to keep (read it first with GET /api/agents/{agent_id}).
The persona section controls the agent’s identity (system prompt, greeting), AI providers (STT / LLM / TTS), actions, memories, and metadata.

Path Parameters

string
required
UUID of the agent to update.

Body Parameters

string
Gender of the agent: male, female or neutral (case-insensitive). Any other value is rejected with 422.
object
Core identity settings.
object
AI provider configuration for speech-to-text, LLM, and text-to-speech.
object
Custom actions the agent can take during a call (provider-specific shape).
object
Memory configuration for the agent (provider-specific shape).
object
Arbitrary metadata key-value pairs attached to the persona.

Request Example


Response