Skip to main content
POST
Update path attributes
Update permissions, ownership, or timestamps for a file or directory.
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
mode
integer

Permission bits, as a decimal integer (420 is 0644).

uid

Owner, as a number or a name.

gid

Group, as a number or a name.

atime
string

Access time, ISO 8601, such as 2026-11-11T10:00:00Z.

mtime
string

Modification time, ISO 8601, such as 2026-11-11T10:00:00Z.

nofollow
boolean

Act on a symbolic link itself rather than its target.

Response

200 - application/json

stored is what the call returns. With explain=true, explanation says what the call would do; nothing runs.

stored
object
required

The fields the backend could not keep, which Mirage stores instead.