Upload a file.

POST

/api/v1/files

Returns the created file record with a TTL. Persist the returned id on a parent record and call FileService::claim() to opt out of cleanup.

Authorizations

• default

Request Body ^required

object

file

required

The file to upload.

string format: binary

visibility

Optional. public or private. Defaults to the configured visibility.

string

nullable

architecto

meta

Optional. Free-form metadata stored alongside the record.

object

[]

Responses

201

object

data

object

id

string

01HX...

client_name

string

photo.jpg

size

integer

12345

expires_at

string

2026-05-11T05:00:00+00:00

{
  "data": {
    "id": "01HX...",
    "client_name": "photo.jpg",
    "size": 12345,
    "expires_at": "2026-05-11T05:00:00+00:00"
  }
}