MOmoda
drive

List Files

Changed on

List drive files (offset pagination, #9317 contract; true total).

EXACTLY the view the app's file browser presents, via the browser's own predicates (FolderService.get_folder_contents / get_root_contents file conditions verbatim): library-visible files only (show_in_library), the shared FileAccessChecker visibility filter (another user's private file is invisible), newest-modified first with the id tiebreaker that keeps pages stable. Folder-scoped listings resolve the folder with the app's rules first: cross-team and other users' private folders are indistinguishable 404s, and hidden system subtrees (brand-kit /.canvas-data machinery) are blocked exactly like folder navigation. The unscoped listing covers the same locations the tree exposes — files inside folders you cannot see stay invisible even when team-visible.

get/drive/files

Request

  • Base URL
    https://api.moda.app/v1
  • URL
    https://api.moda.app/v1/drive/files
  • Auth
    HTTP bearer

Query parameters

folder_idstring nullable

Filter to one location: a folder id (fld_...) for that folder's files, or the literal root for unfiled files. Omit to list every library-visible file across the locations you can see.

limitinteger

Max files per page. Defaults to 50, caps at 200.

offsetinteger

Files to skip — pass offset + limit to page through.

Headers

Moda-Version'2026-04-12' | '2026-05-01'
Example:2026-05-01

Calendar-dated API version pin. New integrations should pin 2026-05-01 to opt into the newest response shapes. For back-compat the server also accepts requests with no header and resolves them to the current default (today: 2026-04-12); that default advances on each sunset date. Any unsupported value returns 400 unsupported_version.

Response

Successful Response

object required

Changes