Skip to main content

Register a file uploaded via pre-signed URL

POST 
/api/v1/storage/gateway/register-uploaded-file

Step 3 of the 3-step upload flow. After PUTting the bytes to the pre-signed URL, call this with the file_id from generate-upload-url (plus the same folder_path and the display file_name) to make the file visible to list-files, get-file-metadata, and generate-download-url. Size and content type are read from the storage backend — client-declared values are not trusted. Idempotent: re-registering an already-registered file_id returns the existing file with registered: false. Registering before the upload completed returns 404.

Request​

Responses​

File registered (or already registered)