Developers
API Reference

Initiate a single-PUT file upload

post
https://dovetail.com/api/v2/files/upload

Initiate a single-PUT upload for files up to 5 GB. The response includes a pre-signed upload_url that the client should PUT the full file body to. After the PUT succeeds, call Complete upload at POST /v2/files/{file_id}/upload/complete.

Files larger than 5 GB must use the large-upload endpoint (POST /v2/files/large-upload) instead.

Once finalized, inspect the file with GET /v1/files/{file_id} and download it with GET /v1/files/{file_id}/download — no v2 read surface exists yet.

Returns 201 with the upload session details. Orphaned uploads that are not completed are eventually cleaned up.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params

Body

string
required
length between 1 and 1024

The file's original name, including extension. 1-1024 characters.

string
required
length ≤ 255

The file's MIME type (e.g. image/png, video/mp4). Up to 255 characters.

integer
required
1 to 5000000000

Total size of the file in bytes. Must be between 1 and 5000000000 (5 GB). For files larger than 5 GB use the large-upload endpoint instead.

Responses

Updated 8 days ago

Language
Credentials
Bearer
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated 8 days ago