Skip to main content
GET
TypeScript SDK
Returns a signed URL to a gzipped tar archive containing one skill directory. Pass the Notion page ID of a skill that is shared with the connection. The archive has one top-level directory containing SKILL.md and any files or folders attached through the skill’s Files property. It does not include a plugin.json file or a skills/ wrapper directory. For an overview of how to use the Agent Skills API, see the guide overview.

Errors

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

Notion-Version
enum<string>
required

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

Available options:
2026-03-11

Path Parameters

id
string
required

Identifier for a Notion skill page.

Response

id
string<uuid>
required

Identifier for the skill page.

version_id
string
required

Stable content version for the generated skill directory.

Required string length: 64
url
string
required

Temporary signed URL for downloading the skill directory archive.

Minimum string length: 1