Start an upload

Regionalus.api.brault.app— follows the region selector in the top bar

Returns a presigned URL (or a multipart session above 256 MiB). PUT the bytes to S3 yourself, then call complete. Send file_id to add a version to an existing file.

Authorization

apiKey

AuthorizationBearer <token>

API key from Settings → Developers

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

name*string

Lengthlength <= 256

size*number

Bytes. Required — the backend reserves and validates against it. At most 5 TiB (S3’s object ceiling).

Rangevalue <= 5497558138880

library_id?string

Library to upload into. Exactly one of library_id, folder_id, file_id.

folder_id?string

Folder to upload into. Exactly one of library_id, folder_id, file_id.

file_id?string

Upload a new VERSION of this file instead of creating one.

to_root?boolean

Not supported on v1; sending true is rejected.

Response Body

`application/json`

curl -X POST "https://example.com/v1/uploads" \  -H "Content-Type: application/json" \  -d '{    "name": "string",    "size": 5497558138880  }'

{  "object": "upload",  "id": "string",  "method": "put",  "file_id": "string",  "version_id": "string",  "upload_url": "string",  "part_size": 0,  "part_count": 0,  "expires_at": "2019-08-24T14:15:22Z"}

Authorization

Request Body

Response Body

201application/json

defaultapplication/json

`application/json`

`application/json`