Skip to main content
GET
TypeScript SDK
Returns the list of available plugins. To fetch an individual plugin from the list, call Get plugin. The response includes plugins for skills shared with the connection. If you see fewer plugins than expected, check the connection’s access to your skills databases. Each unique value in a skills database’s Tags property becomes a plugin. An untagged skill becomes a plugin containing only that skill. For an overview of how to use the Agent Skills API, see the guide overview.

Using version_id

version_id is an opaque string. An unchanged value means the plugin’s contents are unchanged so you can skip re-downloading its directory.

Pagination

This endpoint uses standard cursor pagination. Follow next_cursor until has_more is false.

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

Query Parameters

page_size
integer

The number of items to return. Maximum: 100.

Required range: 1 <= x <= 100
start_cursor
string

An opaque cursor returned by the previous page of results.

Required string length: 1 - 200
Pattern: ^[A-Za-z0-9]+$

Response

object
string
required

Always list

Allowed value: "list"
results
object[]
required
Maximum array length: 100
next_cursor
string | null
required
has_more
boolean
required
type
string
required

Always plugin

Allowed value: "plugin"