Skip to main content
PATCH
/
v2
/
pals
/
{pal_id}
curl --request PATCH \
  --url https://tavusapi.com/v2/pals/{pal_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 PAL"
}
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

​
pal_id
string
required

The unique identifier of the PAL.

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 PAL document. Paths must match the current document shape-compare the response from Get PAL (GET /v2/pals/{pal_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