Start a file upload

POST 
/api/v1/buckets/:bucketId/files

Requires contributor role or above on this bucket. Creates a File record in uploading status and returns a presigned POST policy for the client to upload directly to storage. For providers without bucket-notification support, the client must confirm completion via PATCH .../files/{fileId} with status: uploaded.

Request

Responses

201

Presigned upload policy

400

Validation error

401

Not authenticated. Note: a missing or invalid token is rejected with 403 FORBIDDEN (not 401); 401 is returned when the token's session has been revoked (SESSION_REVOKED).

403

Missing/invalid token, or the caller's role/group is below the required minimum (FORBIDDEN)

404

Bucket or target folder not found (BUCKET_NOT_FOUND, FOLDER_NOT_FOUND)

409

A file with this name already exists in this location (FILE_ALREADY_EXISTS)