Files

Create File Upload

post

Get a signed upload URL for direct GCS upload

Authorizations

HTTPBearer

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

filenamestringRequired

Original filename

size_bytesinteger · min: 1Required

File size in bytes

mime_typeany ofOptional

MIME type of the file

stringOptional

or

nullOptional

Responses

201

Successful Response

application/json

idstringRequired

original_file_namestringRequired

cloud_storage_pathstringRequired

upload_urlstringRequired

Signed GCS upload URL for direct upload

mime_typeany ofRequired

stringOptional

or

nullOptional

size_bytesintegerRequired

metadataany ofOptional

File-level metadata

or

nullOptional

created_atstring · date-timeRequired

expires_atstring · date-timeRequired

When the upload URL expires

422

Validation Error

application/json

post

/files

HTTPcURLJavaScriptPython

POST /api/public/v1/files HTTP/1.1
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 53

{
  "filename": "text",
  "size_bytes": 1,
  "mime_type": "text"
}

{
  "id": "text",
  "original_file_name": "text",
  "cloud_storage_path": "text",
  "upload_url": "text",
  "mime_type": "text",
  "size_bytes": 1,
  "metadata": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  },
  "created_at": "2026-05-14T16:03:57.800Z",
  "expires_at": "2026-05-14T16:03:57.800Z"
}