---
title: "Delete a skill file (its history is kept)"
method: DELETE
path: "/api/preview/capsules/{id}/skill-files"
tags: ["capsule"]
---

# Delete a skill file (its history is kept)

`DELETE /api/preview/capsules/{id}/skill-files`

## 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`
- 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`

## Path parameters

- `id` string, required: UUID v4 string

## Query parameters

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

## Response `200`

Successful response

- object
  - `evicted_revisions` integer, required
  - `file` object, nullable, required
    - `executable` boolean, required
    - `is_text` boolean, required
    - `path` string, required: Path relative to the skill folder, with forward slashes (e.g. `scripts/run.sh`).
    - `revision_id` string, required: UUID v4 string
    - `sha256` string, required
    - `size` integer, required
    - `source_kind` 'stored' | 'linked', required
    - `updated_at` string, required
  - `usage` object, required
    - `current_bytes` integer, required
    - `history_rows` integer, required
    - `path_count` integer, required
    - `retained_bytes` integer, required

## Changes

- **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/delete.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)