Skip to main content
POST
Upload a file to a running session

Authorizations

Authorization
string
header
required

A Reactor API key (rk_...), sent as Authorization: Bearer rk_.... Keep it on a server.

Headers

Reactor-API-Version
string

The API protocol version the client speaks. Currently 1. Older versions than the server's minimum get 426.

Example:

"1"

Path Parameters

session_id
string<uuid>
required

The session's ID, as returned by POST /sessions.

Body

application/json
name
string
required

The file name. Only its base name is used.

Example:

"reference.jpg"

size
integer<int64>
required

The file size in bytes. The upload must send exactly this many bytes.

Required range: x >= 1
mime_type
string
required
Example:

"image/jpeg"

Response

The slot was allocated.

presigned_id
string<uuid>
required

Identifies the upload. Send it to the model in a command.

presigned_url
string<uri>
required

A PUT URL for the bytes, valid for 15 minutes.

path
string
required

Where the file is stored. Send it to the model with presigned_id.