ListFilesResp

  • data
    Type: array object[] · FileSummary[]
    required

    Matching files.

    • 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.

  • pagination
    Type: object · PaginationDto
    required

    Pagination metadata for list responses

    • limit
      Type: integer
      required

      Maximum number of records per page

    • offset
      Type: integer
      required

      Starting position in the result set

    • total
      Type: integer
      required

      Total number of records available