---
title: "POST /api/admin/files/list"
method: POST
path: "/api/admin/files/list"
tags: ["Administration/Files"]
---

# POST /api/admin/files/list

`POST /api/admin/files/list`

## Request body

- object
  - `limit` integer — Number of results per page. The default and maximum vary per endpoint.
  - `page` integer — Page number (1-based). Defaults to 1.
  - `order` 'asc' | 'desc' | 'ASC' | 'DESC'
  - `sort` 'created_at' | 'name' | 'file_type' | 'file_size' | 'bucket_name' | 'content_type'
  - `name` string
  - `bucketName` 'public' | 'private' | 'incoming', nullable
  - `contentType` 'application/msword' | 'application/vnd.openxmlformats-officedocument.wordprocessingml.document' | 'application/octet-stream' | 'application/pdf' | 'text/rtf' | 'application/vnd.ms-powerpoint' | 'application/vnd.openxmlformats-officedocument.presentationml.presentation' | 'application/vnd.ms-excel' | 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet' | 'application/kswps' | 'application/zip' | 'binary/octet-stream' | 'IMAGE' | 'image/bmp' | 'image/gif' | 'image/heic' | 'image/jpeg' | 'image/png' | 'image/svg+xml' | 'image/tiff' | 'image/webp' | 'text/csv' | 'video/mp4' | 'video/webm' | 'video/quicktime' | 'video/x-msvideo' | 'video/x-matroska', nullable
  - `fileType` 'IMAGE' | 'VIDEO' | 'DOCUMENT', nullable

## Response `200`

Default Response

- object
  - `metadata` object, required
    - `success` boolean, required — True when the request succeeded.
    - `pagination` object
      - `page` number, required — Current page number (1-based).
      - `limit` number, required — Page size used for this response. Endpoint defaults vary — see each endpoint's limit parameter.
      - `total` number, required — Total number of records across all pages.
      - `totalPages` number, required — Total number of pages. Iterate until page reaches totalPages.
  - `data` object[], required
    - `id` string, required
    - `bucketName` 'public' | 'private' | 'incoming', required
    - `url` string, required
    - `name` string, required
    - `fileType` 'IMAGE' | 'VIDEO' | 'DOCUMENT', nullable, required
    - `documentText` string, nullable
    - `contentType` 'application/msword' | 'application/vnd.openxmlformats-officedocument.wordprocessingml.document' | 'application/octet-stream' | 'application/pdf' | 'text/rtf' | 'application/vnd.ms-powerpoint' | 'application/vnd.openxmlformats-officedocument.presentationml.presentation' | 'application/vnd.ms-excel' | 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet' | 'application/kswps' | 'application/zip' | 'binary/octet-stream' | 'IMAGE' | 'image/bmp' | 'image/gif' | 'image/heic' | 'image/jpeg' | 'image/png' | 'image/svg+xml' | 'image/tiff' | 'image/webp' | 'text/csv' | 'video/mp4' | 'video/webm' | 'video/quicktime' | 'video/x-msvideo' | 'video/x-matroska', nullable, required
    - `contentMd5Hash` string, nullable
    - `fileHash` string, nullable, required
    - `fileSize` number, nullable, required
    - `isMigrated` integer, nullable, required
    - `isPrivate` integer, nullable, required
    - `uploadUrl` string, nullable
    - `originalUrl` string, nullable
    - `previewUrl` string, nullable
    - `createdAt` string, date-time, nullable, required
    - `createdBy` string, nullable, required
    - `createdByCompanyId` string, nullable, required
    - `createdByApiKeyId` string, nullable, required
    - `createdByApiKeyLabel` string, nullable, required
    - `createdByImpersonateId` string, nullable, required
    - `createdByImpersonateName` string, nullable, required
    - `createdByUserId` string, nullable, required
    - `updatedAt` string, date-time, nullable, required
    - `updatedByApiKeyId` string, nullable, required
    - `updatedByApiKeyLabel` string, nullable, required
    - `updatedByCompanyId` string, nullable, required
    - `updatedByCompanyName` string, nullable, required
    - `updatedByImpersonateId` string, nullable, required
    - `updatedByImpersonateName` string, nullable, required
    - `updatedByUserId` string, nullable, required
    - `updatedByUserName` string, nullable, required
    - `normalizeAttemptedAt` string, date-time, nullable

## Changes

> 22 revisions in range; 1 not diffed.

- **2026-08-31** `97e51f27dc77` — 35 breaking, 30 warning, 65 info
  - request property `bucketName` was restricted to a list of enum values
  - request property `contentType` was restricted to a list of enum values
  - request property `fileType` was restricted to a list of enum values
  - request property `bucketName` list-of-types was narrowed by removing types `null` from media type `application/json`
  - …126 more

[Change history](https://skmtc.dev/retraced/apis/api-reference/changes/api/admin/files/list/post.md)

---

[API](https://skmtc.dev/retraced/apis/api-reference.md) · [All operations](https://skmtc.dev/retraced/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/retraced/api-reference/revisions/97e51f27dc77/schema)