API ReferenceFiles

Upload a file

Uploads a file to be referenced in future API calls. The file is stored under the workspace of the authenticating API key. Maximum file size: 100 MB.

Authentication

AuthorizationBearer
API key as bearer token in Authorization header

Query parameters

workspace_idstringOptionalformat: "uuid"

Workspace to scope the request to. Defaults to the caller’s default workspace.

Request

This endpoint expects a multipart form containing a file.
filefileRequired

Response

The uploaded file metadata.
created_atstring
downloadableboolean
filenamestring
idstring
mime_typestring
size_bytesinteger
typeenum

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
413
Content Too Large Error
429
Too Many Requests Error
500
Internal Server Error