Skip to main content
PUT
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

The configuration for the skill, validated against the skill's config schema. Defaults to {}.

  • presentation: document_ids (required array), optional slides_trigger (on_demand (default) or walk_the_deck), optional prompt.
  • magic_canvas: optional sparse components overlay, plus optional usage_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.
Example:

Response

Successfully attached the skill

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 and config.usage_guidance is an optional string (max 2048 characters) that steers when the PAL shows cards; see Canvas configuration.

Example:
​
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"