Skip to main content
PATCH
Update an brand persona

Authorizations

X-API-Key
string
header
required

[Production] API key for production authentication

Path Parameters

id
string
required

The unique identifier for the brand persona.

Body

application/json

Brand persona update data

description
string
image
string
imageOptimizedFormat
boolean
name
string
speakingStyle
object
voiceConfig
object

Deprecated: voice settings are moving to the agent's own voice-config-defaults builtin tool instance, which is per-agent (a persona is a brand identity several agents share, while call behaviour is not). The persona keeps name, description, speaking style and avatar. Still read as a fallback for the block's language when the agent has no baseline; still required on create, so removing it is a coordinated breaking change rather than a tidy-up. See planning/plans/voice-native-poc/agent-voice-configs-plan.md.

Response

OK

createdAt
integer
createdBy
string
Example:

"507f1f77bcf86cd799439011"

description
string
id
string
Example:

"507f1f77bcf86cd799439011"

image
string
imageOptimizedFormat
boolean
lastChangedAt
integer
lastChangedBy
string
Example:

"507f1f77bcf86cd799439011"

name
string
organisationId
string
Example:

"507f1f77bcf86cd799439011"

projectId
string
Example:

"507f1f77bcf86cd799439011"

referenceId
string
speakingStyle
object
voiceConfig
object

Deprecated: voice settings are moving to the agent's own voice-config-defaults builtin tool instance, which is per-agent (a persona is a brand identity several agents share, while call behaviour is not). The persona keeps name, description, speaking style and avatar. Still read as a fallback for the block's language when the agent has no baseline; still required on create, so removing it is a coordinated breaking change rather than a tidy-up. See planning/plans/voice-native-poc/agent-voice-configs-plan.md.