FileSummary

  • createdAt
    Type: stringFormat: date-time
    required

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

  • 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
  • size
    Type: integer

    Size of the file in bytes, when known.