Update file metadata or retention
Updates a file’s display name, visibility, retention period, or metadata. The body schema is strict: unknown keys are rejected.
name excludes the extension. To change the extension you must upload a new version.
Required scopes: buckets:write + files:write.
Authorizations
Public half of the company API key. Format: pk_ followed by 64 hexadecimal characters.
Secret half of the company API key. Format: sk_ followed by 64 hexadecimal characters. Stored as a hash server-side and shown only at creation or rotation.
Path Parameters
File identifier.
Body
Strict schema. Unknown keys are rejected.
Display name, without the extension.
1 - 255private, public 30d, 45d, 90d, 120d, 180d, 1Y, 2Y, 3Y, 5Y Free-form metadata object. Tags are managed through dedicated dashboard flows.
Client-side optimistic-concurrency token. Accepted but not trusted for writes.
x >= 1