Skip to main content
PATCH
/
v2
/
personas
/
{persona_id}
curl --request PATCH \ --url https://tavusapi.com/v2/personas/{persona_id} \ --header 'Content-Type: application/json' \ --header 'x-api-key: <api-key>' \ --data ' [ { "op": "replace", "path": "/system_prompt", "value": "As a Life Coach, you are a dedicated professional who specializes in..." } ] '
{
  "message": "No changes were made to the persona"
}

Documentation Index

Fetch the complete documentation index at: https://docs.tavus.io/llms.txt

Use this file to discover all available pages before exploring further.

For AI agents, use https://docs.tavus.io/openapi.yaml for the full HTTP API contract.

Authorizations

​
x-api-key
string
header
required

Path Parameters

​
persona_id
string
required

The unique identifier of the persona.

Example:

"pcb7a34da5fe"

Body

application/json
​
op
enum<string>
required

The operation to perform. Must be one of: add, remove, replace, copy, move, test

Available options:
add,
remove,
replace,
copy,
move,
test
Example:

"add"

​
path
string
required

JSON Pointer (RFC 6901) to a location in the persona document. Paths must match the current document shape—compare the response from Get Persona (GET /v2/personas/{persona_id}) before patching.

Example:

"/layers/llm/model"

​
value
string
required

The value to be used within the operation. This field is not required for the remove operation.

Example:

"tavus-llama-4"

Response

OK