---
title: "Rename a skill file, keeping its identity and bytes"
method: POST
path: "/api/preview/capsules/{id}/skill-files/move"
tags: ["capsule"]
---

# Rename a skill file, keeping its identity and bytes

`POST /api/preview/capsules/{id}/skill-files/move`

## 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/move`
- 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/move/post.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `id` string, required: UUID v4 string

## Request body

- object
  - `expected_revision_id` string, required: The file's current head revision. A different current head is refused with `stale_revision`.
  - `new_path` string, required: Path relative to the skill folder, with forward slashes (e.g. `scripts/run.sh`).
  - `path` string, required: Path relative to the skill folder, with forward slashes (e.g. `scripts/run.sh`).

## 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-13** `24536ef7ac40`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/symbol-chat/apis/symbol-api/changes/api/preview/capsules/:id/skill-files/move/post.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)