---
title: "List skills plugins"
method: GET
path: "/v1/ai/plugins"
tags: ["Agent Skills"]
---

# List skills plugins

`GET /v1/ai/plugins`

## Request

- Base URL: `https://api.notion.com`
- URL: `https://api.notion.com/v1/ai/plugins`
- Auth: HTTP bearer

## Query parameters

- `page_size` integer: The number of items to return. Maximum: 100.
- `start_cursor` string: An opaque cursor returned by the previous page of results.

## Headers

- `Notion-Version` '2026-03-11', required

## Response `200`

- object
  - `object` 'list', required: Always `list`
  - `results` object[], required
    - `id` string, required
    - `name` string, required
    - `description` string, required
    - `version_id` string, required: Opaque version identifier for the plugin. Compare this value for equality to determine whether the plugin has changed.
  - `next_cursor` string, nullable, required
  - `has_more` boolean, required
  - `type` 'plugin', required: Always `plugin`

## Other responses

- `400`
- `401`
- `403`
- `404`
- `406`
- `409`
- `429`
- `500`
- `503`
- `504`
- `529`

## Changes

- **2026-09-16** `228a8f2a4f22`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/notion/apis/notion-api/changes/v1/ai/plugins/get.md)

---

[API](https://skmtc.dev/notion/apis/notion-api.md) - [All operations](https://skmtc.dev/notion/apis/notion-api/llms.txt) - [OpenAPI document](https://skmtc.dev/notion/apis/notion-api/revisions/db15ae6a4928?raw)