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

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-03-10T22:59:15.673Z",
  "expires_at": "2026-03-10T22:59:15.673Z"
}