Skip to main content
POST
Rename path
Rename a file or directory within the same mount.
See error examples and recovery steps. The complete OpenAPI contract includes every response schema.

Authorizations

Authorization
string
header
required

The server's token (MIRAGE_AUTH_TOKEN) or a JWT. A daemon in the default local mode with no token accepts requests without one.

Path Parameters

workspace_id
string
required

Workspace ID.

Query Parameters

session_id
string

Session ID to use. If omitted, the default session is used.

explain
boolean
default:false

Return what the call would do without running it.

Body

application/json
src
string
required

Path to rename.

dst
string
required

New path, on the same mount.

Response

200 - application/json

An empty object when the call succeeds. With explain=true, explanation says what the call would do; nothing runs.

An empty object.