Files

Get file

Returns metadata for a REST API uploaded file owned by the authenticated account.

get/api/v1/files/{file_id}

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/{file_id}
  • Auth: HTTP bearer

Path parameters

file_idstring required

Query parameters

externalUserIdstring nullable

Optional developer-user guard. When provided, the file is returned only if its stored externalUserId matches this value.

Headers

authorizationstring nullable

Response

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.