Agent HandlerFiles

Reserve a file upload

Registers a file’s metadata and returns a short-lived upload URL plus the file_reference an upload tool takes. No bytes move here; send them to the upload URL next.

Authentication

AuthorizationBearer

Token-based authentication with required prefix “Bearer”

Request

This endpoint expects an object.
filenamestringRequired<=255 characters
Name the file will carry into the connector.
content_typestringOptional<=255 charactersDefaults to application/octet-stream

MIME type of the bytes; defaults to application/octet-stream.

size_bytesintegerOptional1-52428800

Optional. Rejects a file over the limit before you send any bytes; the upload enforces the limit regardless.

Response

file_referencestring

Pass this as the file_reference argument of an upload tool once the bytes are uploaded.

uploadobject
Where and how to send the file's bytes.
max_size_bytesinteger
Largest file this upload accepts, in bytes.
expires_atdatetime
When the upload URL and the file reference both stop working.

Errors

400
Bad Request Error