Skip to main content
GET
TypeScript SDK
Pass in an id from List plugins. Returns a signed URL to a gzipped tar archive of a plugin directory following the Agent Plugins standard. Currently plugins returned by Notion only contain skills and no MCP resources or extensions, but this may change in the future. You should treat the entire folder returned by the API as a standard-compliant plugin. For an overview of how to use the Agent Skills API, see the guide overview.

Plugin size limits

A plugin directory includes at most 100 skills; when a plugin has more, the most recently updated ones are included.

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
Required string length: 1 - 200
Pattern: ^[^\u0000-\u001f\u007f]+$
Example:

"9b4a1d3f-1f0a-4c2a-9f0b-6c1f5a3d2e10"

Response

id
string
required
version_id
string
required

Opaque version identifier for the plugin directory. Compare this value for equality to determine whether the directory has changed. This matches the version_id in the corresponding plugin summary.

Required string length: 64
url
string
required

Temporary signed URL for downloading the plugin directory as a gzipped tar archive.