FileResp

  • contentType
    Type: string
    required

    MIME type of the file's bytes (e.g., application/pdf, image/png).

  • createdAt
    Type: stringFormat: date-time
    required

    ISO 8601 / RFC 3339 timestamp of the file's reservation.

  • downloadUrl
    Type: string
    required

    Time-limited URL for fetching the file's bytes directly from cloud storage. Pre-authorized — issue a plain GET (do not attach an Authorization: Bearer header; the URL carries short-lived credentials in its query string and the storage backend rejects extra auth headers). If it expires, call GET /files/{fileId} again for a fresh one.

  • id
    Type: string Pattern: ^f_[0-9a-z]{26}$
    required

    Canonical, immutable identifier for this file. Prefixed lowercase ULID, e.g. f_01jv8m7qfj6xj9gkz7a4s2h8e.

  • name
    Type: string
    required

    Display name for the file, as supplied at upload time.

  • status
    Type: stringenum
    required

    uploading while the upload-URL is reserved but bytes haven't landed; available once the bytes are stored and the file can be referenced elsewhere.

    values
    • uploading
    • available
  • updatedAt
    Type: stringFormat: date-time
    required

    ISO 8601 / RFC 3339 timestamp of the most recent change (e.g., upload completion).

  • hash
    Type: string

    SHA-256 hash of the file's bytes, as supplied by the uploader at request time. Returned only when the uploader provided one.

  • hashAlgorithm
    Type: string

    Algorithm used to compute hash (e.g., sha256).

  • size
    Type: integer

    Size of the file in bytes, when known.