curl --request PUT \
--url https://tavusapi.com/v2/pals/{pal_id}/skills/{skill_id} \
--header 'Content-Type: application/json' \
--header 'x-api-key: <api-key>' \
--data '{
"config": {}
}'{
"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"
}{
"error": "Bad Request: {'document_ids': ['Missing data for required field.']}"
}{
"message": "Invalid access token"
}{
"error": "Unknown skill 'my_skill'"
}Attach Skill to PAL
Attach a skill to a PAL, or overwrite the configuration of an existing attachment. The skill is active on the PAL’s next conversation.
Skills with no configuration (like internet_search) take an empty body or {"config": {}}. See Skills for each skill’s configuration fields. For magic_canvas, see Canvas configuration.
curl --request PUT \
--url https://tavusapi.com/v2/pals/{pal_id}/skills/{skill_id} \
--header 'Content-Type: application/json' \
--header 'x-api-key: <api-key>' \
--data '{
"config": {}
}'{
"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"
}{
"error": "Bad Request: {'document_ids': ['Missing data for required field.']}"
}{
"message": "Invalid access token"
}{
"error": "Unknown skill 'my_skill'"
}https://docs.tavus.io/openapi.yaml for the full HTTP API contract.Path Parameters
Body
The configuration for the skill, validated against the skill's config schema. Defaults to {}.
presentation:document_ids(required array), optionalslides_trigger(on_demand(default) orwalk_the_deck), optionalprompt.magic_canvas: optional sparsecomponentsoverlay, plus optionalusage_guidance(string, max 2048 characters) appended to the Canvas system prompt to steer when the PAL shows cards. Ignored when blank or when no Canvas component is active. See Canvas configuration.
{
"document_ids": ["d1234567890", "d2468101214"],
"slides_trigger": "walk_the_deck",
"prompt": "Walk the participant through the Q4 roadmap deck."
}
Response
Successfully attached the skill
A skill attached to a PAL.
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 and config.usage_guidance is an optional string (max 2048 characters) that steers when the PAL shows cards; see Canvas configuration.
{
"document_ids": ["d1234567890", "d2468101214"],
"slides_trigger": "walk_the_deck",
"prompt": "Walk the participant through the Q4 roadmap deck."
}

