Files
Upload init
Registers one or more files and answers, in the same order as the input, either with a pre-signed URL to PUT the file to (valid for 90 minutes) or with EXIST_SKIP_UPLOAD and the id of an identical file already stored for this tenant, matched on the supplied MD5 or SHA256. Every entry needs a filename, an MD5 and a size, and no file may exceed 120 MB.
POST
/api/{tenant:minlength(2)}/v{version:apiVersion}/files/upload_init
Request arguments
| Name | Type | Source |
|---|---|---|
| inputs | DTO_file_upload_init[] | Body |
Request body example
Response
Response body example
DTO_file_upload_init
| Name | Type | ReadOnly | Description |
|---|---|---|---|
| filename | String | Filename | |
| size_bytes | Int64 | Size bytes | |
| hash_md5 | String | Hash md5 |
DTO_file_upload_init_response
| Name | Type | ReadOnly | Description |
|---|---|---|---|
| file_id | Int32 | File id | |
| filename | String | To idenfity file in a collection of upload requests | |
| md5 | String | Md5 | |
| signed_upload_url | String | Signed upload url | |
| status | ENUM file_upload_init_status | Status |
ENUM file_upload_init_status
| Value | Name | Description |
|---|---|---|
| 0 | UNKNOWN | UNKNOWN |
| 1 | UPLOAD | Upload |
| 2 | EXIST_SKIP_UPLOAD | Exist, skip upload |
Generated Aug 4, 2026 18:37