Skip to main content
PATCH
/
v2
/
pals
/
{pal_id}
/
skills
/
{skill_id}
Update PAL Skill
curl --request PATCH \
  --url https://tavusapi.com/v2/pals/{pal_id}/skills/{skill_id} \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "config": {
    "slides_trigger": "on_demand"
  }
}
'
{
  "skill_id": "presentation",
  "config": {
    "document_ids": [
      "d1234567890",
      "d2468101214"
    ],
    "slides_trigger": "walk_the_deck",
    "prompt": "Walk the participant through the Q4 roadmap deck."
  },
  "attached_at": "2026-06-10T14:30:45.123456+00:00",
  "updated_at": "2026-06-10T14:30:45.123456+00:00"
}
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"

​
skill_id
string
required

The unique identifier of the skill.

Example:

"presentation"

Body

application/json
​
config
object
required

Partial configuration to merge into the existing config.

Example:
{ "slides_trigger": "on_demand" }

Response

Successfully updated the skill attachment

A skill attached to a PAL.

​
skill_id
string

The unique identifier of the attached skill.

Example:

"presentation"

​
config
object

The skill's configuration. Empty object for skills with no configuration.

Shape depends on skill_id - see Skills. For magic_canvas, config.components is a sparse overlay; see Canvas configuration.

Example:
{
  "document_ids": ["d1234567890", "d2468101214"],
  "slides_trigger": "walk_the_deck",
  "prompt": "Walk the participant through the Q4 roadmap deck."
}
​
attached_at
string

ISO 8601 timestamp of when the skill was first attached to the PAL.

Example:

"2026-06-10T14:30:45.123456+00:00"

​
updated_at
string

ISO 8601 timestamp of when the attachment was last modified.

Example:

"2026-06-10T14:30:45.123456+00:00"