KHkhotan
Files

List files

Returns the organization's non-deleted files ordered newest first, with cursor pagination (default 50 per page, max 200). By default only ready files appear; pass status=pending to list incomplete uploads that have not passed their upload expiry window (cancel them with DELETE /api/v1/files/{fileId}). Scope the list with folderId or path (mutually exclusive); path=/ means the root folder, and omitting both lists every folder. Each file includes contentUrl, a stable authenticated API URL for opening the file content.

get/api/v1/files

Request

  • Base URL
    https://app.khotan.com
  • URL
    https://app.khotan.com/api/v1/files
  • Auth
    • HTTP bearer
    • or API key in header x-api-key

Query parameters

folderIdstring
pathstring

A folder path such as "/invoices/2026". Segments match active folders case-insensitively; "/" means the root.

status'ready' | 'pending'

File status filter. Default ready. Use pending to list incomplete uploads that have not passed their upload expiry window; cancel them with DELETE /api/v1/files/{fileId}.

limitinteger
cursorstring

Response

One page of the organization's files.

nextCursorstring nullable required

Opaque cursor for the next page; null when no more results.

Changes

No recorded changes to this operation across all 1 revision of this API.