v1

latestOpenAPI 3.0.32026-07-267015229.9 KB

Skills

Update PAL Skill

Merge changes into an existing skill attachment's configuration. Fields you pass replace the existing values, fields you omit are preserved, and fields set to null are removed. The merged configuration is validated against the skill's config schema.

Unlike Attach Skill to PAL, this endpoint cannot create a new attachment - the skill must already be attached.

patch/v2/pals/{pal_id}/skills/{skill_id}

Request body

configobject required

Partial configuration to merge into the existing config.

Example request

{
  "config": {
    "slides_trigger": "on_demand"
  }
}

Response

Successfully updated the skill attachment

skill_idstring

The unique identifier of the attached skill.

configobject

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.

attached_atstring

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

updated_atstring

ISO 8601 timestamp of when the attachment was last modified.

Example response

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