Skip to main content
POST
Create a new brand persona

Authorizations

X-API-Key
string
header
required

[Production] API key for production authentication

Body

application/json

Brand persona data

name
string
required
projectId
string
required
speakingStyle
object
required
voiceConfig
object
required

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.

description
string
image
string
imageOptimizedFormat
boolean

Response

Created

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.