Agent Skills
Get plugin
Download a plugin directory containing skills and supporting files.
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
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Headers
The API version to use for this request. The latest version is 2026-03-11.
Available options:
2026-03-11 Path Parameters
Required string length:
1 - 200Pattern:
^[^\u0000-\u001f\u007f]+$Example:
"9b4a1d3f-1f0a-4c2a-9f0b-6c1f5a3d2e10"
Response
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:
64Temporary signed URL for downloading the plugin directory as a gzipped tar archive.