Files

Upload small file

Small-file convenience upload. This route is capped at 25 MB and is deprecated for developer-platform use; prefer POST /files/uploads.

post/api/v1/files

Request

  • Base URL: https://api.studio.kaitoi.io (the document declares no server; this is the origin it was published from)
  • URL: https://api.studio.kaitoi.io/api/v1/files
  • Auth: HTTP bearer

Headers

Idempotency-Keystring nullable
authorizationstring nullable

Response

Uploaded file metadata.

fileIdstring required

Stable file identifier for REST API inputs and outputs.

filenamestring required

Original filename supplied by the developer.

contentTypestring required

Detected or supplied media type.

sizeBytesinteger required

Stored file size in bytes.

externalIdstring nullable

Developer-provided external file identifier.

externalUserIdstring nullable

Developer-provided end-user identifier.

externalWorkspaceIdstring nullable

Developer-provided workspace/team identifier.

createdAtstring date-time required

Upload timestamp.

updatedAtstring date-time required

Last metadata update timestamp.

Example response

{
  "contentType": "image/png",
  "createdAt": "2026-05-24T12:00:00+00:00",
  "externalId": "asset_123",
  "externalUserId": "user_789",
  "externalWorkspaceId": "team_456",
  "fileId": "2f8f8c5df80e4f76a5b7d1bbd6fae0ab.png",
  "filename": "input.png",
  "sizeBytes": 12345,
  "updatedAt": "2026-05-24T12:00:00+00:00"
}

Changes

No recorded changes to this operation across all 1 revision of this API.