EndpointsFiles

Create a file upload

Register an upload and receive presigned S3 upload target(s) plus a file handle (file_id and one_time_secret). Use the returned upload target(s) to send the file directly, then pass the file handle to domain endpoints to claim ownership once the upload completes.

Token scopes: files:write

Authentication

AuthorizationBearer
## Authentication The Deel API uses bearer tokens to authenticate requests. All API calls must be made over HTTPS — calls over plain HTTP or without authentication will fail. ```curl curl -X GET 'https://api.letsdeel.com/rest/v2/contracts' \ -H 'Authorization: Bearer YOUR-TOKEN-HERE' ``` [Learn more about authentication](/api/authentication)
OR
AuthorizationBearer
Standard OAuth2 security scheme based on https://swagger.io/docs/specification/authentication/

Headers

x-upload-methodenumOptional

Declares the client is multipart-capable. The server returns a multipart response only when the declared size exceeds the configured multipart threshold (MULTIPART_THRESHOLD); otherwise the standard POST form.

Allowed values:

Request

Upload registration parameters
dataobjectRequired

Response

Upload registered successfully with presigned S3 upload target(s)

dataobject

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
404
Not Found Error
500
Internal Server Error