---
title: "Get a skill directory"
method: GET
path: "/v1/ai/skills/{id}"
tags: ["Agent Skills"]
---

# Get a skill directory

`GET /v1/ai/skills/{id}`

## Request

- Base URL: `https://api.notion.com`
- URL: `https://api.notion.com/v1/ai/skills/{id}`
- Auth: HTTP bearer

## Path parameters

- `id` string, required

## Headers

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

## Response `200`

- object
  - `id` string, uuid, required: Identifier for the skill page.
  - `version_id` string, required: Stable content version for the generated skill directory.
  - `url` string, required: Temporary signed URL for downloading the skill directory archive.

## 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/skills/:id/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/8967a2a7b255?raw)