---
title: "List a skill's file revisions, newest first, including deleted files (editors only)"
method: GET
path: "/api/preview/capsules/{id}/skill-files/history"
tags: ["capsule"]
---

# List a skill's file revisions, newest first, including deleted files (editors only)

`GET /api/preview/capsules/{id}/skill-files/history`

## Request

- Base URL: `https://symbol.chat` (the document declares no server; this is the origin it was published from)
- URL: `https://symbol.chat/api/preview/capsules/{id}/skill-files/history`
- Auth: one of:
  - HTTP bearer
  - API key in cookie `__Secure-next-auth.session-token`
  - OAuth 2
    - Authorization code: `https://mcp.symbol.chat/authorize`
    - Token URL: `https://mcp.symbol.chat/token`
- TypeScript: <https://skmtc.dev/symbol-chat/apis/symbol-api/docs/api/preview/capsules/:id/skill-files/history/get.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `id` string, required: UUID v4 string

## Query parameters

- `path` string: Path relative to the skill folder, with forward slashes (e.g. `scripts/run.sh`).

## Response `200`

Successful response

- object
  - `revisions` object[], required
    - `action` 'create' | 'replace' | 'chmod' | 'delete' | 'restore' | 'move', required
    - `created_at` string, required
    - `deleted` boolean, required
    - `executable` boolean, nullable, required
    - `is_current` boolean, required
    - `path` string, required: Path relative to the skill folder, with forward slashes (e.g. `scripts/run.sh`).
    - `restorable` boolean, required
    - `revision_id` string, required: UUID v4 string
    - `revision_num` integer, required
    - `sha256` string, nullable, required
    - `size` integer, nullable, required
    - `source_kind` 'stored' | 'linked', required

## Changes

- **2026-11-13** `24536ef7ac40`: 1 warning
  - added the new `move` enum value to the `revisions/items/action` response property for the response status `200`
- **2026-11-08** `fd7b0a7085e4`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/symbol-chat/apis/symbol-api/changes/api/preview/capsules/:id/skill-files/history/get.md)

---

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