Persona
Patch Persona
This endpoint updates a persona using a JSON Patch payload (RFC 6902). You can modify any field within the persona using supported operations like add, remove, replace, copy, move, and test.
For example:
[
{ "op": "replace", "path": "/persona_name", "value": "Wellness Advisor" },
{ "op": "replace", "path": "/default_replica_id", "value": "r79e1c033f" },
{ "op": "replace", "path": "/context", "value": "Here are a few times that you have helped an individual make a breakthrough in..." },
{ "op": "replace", "path": "/layers/llm/model", "value": "tavus-gpt-4o" },
{ "op": "replace", "path": "/layers/tts/tts_engine", "value": "cartesia" },
{ "op": "add", "path": "/layers/tts/tts_emotion_control", "value": "true" },
{ "op": "remove", "path": "/layers/stt/hotwords" },
{ "op": "replace", "path": "/layers/perception/perception_tool_prompt", "value": "Use tools when identity documents are clearly shown." }
]
PATCH
- Ensure the
pathmatch the current persona schema. - For the
removeoperation, thevalueparameter is not required.
Authorizations
Path Parameters
The unique identifier of the persona.
Example:
"pf3073f2dcc1"
Body
application/json
The operation to perform. Must be one of: add, remove, replace, copy, move, test
Available options:
add, remove, replace, copy, move, test Example:
"add"
A JSON Pointer string that references a location within the target document where the operation is performed
Example:
"/layers/llm/model"
The value to be used within the operation. Each request must have a value field unless you're using remove operation.
Example:
"tavus-llama-4"
Response
OK