Attach Skill to PAL

{ "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" }

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 - see Canvas configuration.

Example:

{
  "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.

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"