Skip to main content
POST
Resize file
Resize a file to the specified byte length.
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
path
string
required
length
integer
required

New size in bytes. A longer length pads the file with zero bytes.

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.