Upload an input file

Stores an input file in private temporary storage. Requires files:write.

POST/files

Authorization

AuthorizationBearer <token>

Headers

Idempotency-Keystringrequired

minLength: 1
maxLength: 255

Bodyrequired

multipart/form-data

object

filestringrequired

format: "binary"

Response

application/json

Stored input file.

object

idstringrequired

objectstringrequired

const: "file"

bytesintegerrequired

created_atintegerrequired

expires_atinteger | nullrequired

filenamestringrequired

purposestringrequired

enum: ["input","output"]

media_typestringrequired

curl --request POST \
  --url 'https://YOUR_SALAMBO_BASE_URL/api/v1/files' \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Idempotency-Key: YOUR_IDEMPOTENCY_KEY' \
  --form 'file=@path/to/file'

Replace placeholders with your values.

Response

{
  "id": "<string>",
  "object": "file",
  "bytes": 123,
  "created_at": 123,
  "expires_at": 123,
  "filename": "<string>",
  "purpose": "input",
  "media_type": "<string>"
}