Skip to main content
PUT
/
v2
/
pals
/
{pal_id}
/
skills
Replace PAL Skills
curl --request PUT \
  --url https://tavusapi.com/v2/pals/{pal_id}/skills \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "skills": {
    "internet_search": {},
    "presentation": {
      "config": {
        "document_ids": [
          "d1234567890"
        ],
        "slides_trigger": "on_demand"
      }
    },
    "magic_canvas": {
      "config": {}
    }
  }
}
'
{
  "data": {}
}
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
​
skills
object
required

The complete skill set for the PAL, keyed by skill_id. Each value holds that skill's config object (omit or pass {} for skills with no configuration).

Example:
{
  "internet_search": {},
  "presentation": {
    "config": {
      "document_ids": ["d1234567890"],
      "slides_trigger": "on_demand"
    }
  },
  "magic_canvas": { "config": {} }
}

Response

Successfully replaced the PAL's skill attachments

​
data
object

The PAL's new skill attachments keyed by skill_id.