Agent Skills

Upload a skill

Changed on
post/v1/ai/skills/{id}/upload

Request

  • Base URL
    https://api.notion.com
  • URL
    https://api.notion.com/v1/ai/skills/{id}/upload
  • Auth
    HTTP bearer

Path parameters

idstring required

Headers

Notion-Version'2026-03-11' required

The API version to use for this request. The latest version is 2026-03-11.

Request body multipart/form-data

fileobject required

The skill directory as a gzip-compressed tar archive (maximum 20 MiB).

Response

status'completed' required

Import committed.

page_idstring uuid required

Updated skill page.

version_idstring required

Content version of the uploaded skill. Matches version_id from GET /v1/ai/skills/{id} until the skill changes.

Changes