Skip to content
Kumquat
Esc
↑↓navigate↵open⌘Jpreview

List Folder Files

Files synced from a Drive folder, ordered by name the way a person reads it — 1, 2, 3 … 10, not 1, 10, 2. The files are named after the task’s creatives, so the variation number in the name is what the listing counts along; Drive’s own clock only breaks ties between files sharing a name.

parents is the ancestor chain rather than the immediate parent, so files sitting in a subfolder are listed too — and it is the indexed path. Unlike the other collections here the page is offset-based: a folder holds tens of files, not a feed.

A row carries everything the file dialog shows, not just the tile: the dialog is opened on a file this page already described, and a folder is stepped through with the arrow keys.

GET/api/v1/gdrive-files/folders/{folder_id}
Authorization
AuthorizationBearer token · headerrequired
or
AuthorizationOAuth2 access token · headerrequired
Path parameters
folder_idstringrequired
Drive folder id, e.g. a task's `drive_folder_id`
min length 1
Query parameters
limitinteger
min 1 · max 100 · default: 50
offsetinteger
min 0 · default: 0
Responses
200Successful Response
successboolean
default: true
dataGdriveFolderFiles | any
Show properties
Any of:
GdriveFolderFiles
filesGdriveFolderFile[]required
Show properties
Array of GdriveFolderFile
drive_file_idstringrequired
namestringrequired
mime_typestring | any
Show properties
Any of:
string
string
any
any
sizeinteger | any
Show properties
Any of:
integer
integer
any
any
file_created_atstring<date-time> | any
Show properties
Any of:
string<date-time>
string<date-time>
any
any
updated_atstring<date-time> | any
Show properties
Any of:
string<date-time>
string<date-time>
any
any
duplicates_countinteger
default: 0
probeProbeInfo | any
Show properties
Any of:
ProbeInfo
duration_msinteger | any
Show properties
Any of:
integer
integer
any
any
widthinteger | any
Show properties
Any of:
integer
integer
any
any
heightinteger | any
Show properties
Any of:
integer
integer
any
any
codecstring | any
Show properties
Any of:
string
string
any
any
bitrateinteger | any
Show properties
Any of:
integer
integer
any
any
has_audioboolean | any
Show properties
Any of:
boolean
boolean
any
any
any
any
video_urlstring | any
Show properties
Any of:
string
string
any
any
original_urlstring | any
Show properties
Any of:
string
string
any
any
preview_urlstring | any
Show properties
Any of:
string
string
any
any
metaPaginationMetarequired
Show properties
totalintegerrequired
limitintegerrequired
offsetintegerrequired
any
any
messagestring | any
Show properties
Any of:
string
string
any
any
errorsstring[] | any
Show properties
Any of:
string[]
Array of string
string
any
any
422Validation Error
detailValidationError[]
Show properties
Array of ValidationError
locstring | integer[]required
Show properties
Array of string | integer
Any of:
string
string
integer
integer
msgstringrequired
typestringrequired
inputany
ctxobject
Request
curl -X GET "/api/v1/gdrive-files/folders/string" \
  -H "Authorization: Bearer YOUR_TOKEN"
Response
{
  "success": true,
  "data": {
    "files": [
      {
        "drive_file_id": "string",
        "name": "string",
        "mime_type": "string",
        "size": 0,
        "file_created_at": "2019-08-24T14:15:22Z",
        "updated_at": "2019-08-24T14:15:22Z",
        "duplicates_count": 0,
        "probe": {
          "duration_ms": 0,
          "width": 0,
          "height": 0,
          "codec": "string",
          "bitrate": 0,
          "has_audio": true
        },
        "video_url": "string",
        "original_url": "string",
        "preview_url": "string"
      }
    ],
    "meta": {
      "total": 0,
      "limit": 0,
      "offset": 0
    }
  },
  "message": "string",
  "errors": [
    "string"
  ]
}