List folders
Lists the drive's folders, or its trash with ?trashed=true. Named file-folders because /v1/folders is mail's.
GET
/v1/file-folders
Permission
The key must be granted files.read
A key without it gets 403 insufficient_scope, with the missing permission named in details.
A flat list with parent ids rather than a nested tree, so a caller can build whichever shape it needs without this API deciding the depth. Not paged.
Query parameters
| Field | Type | Description |
|---|---|---|
trashed |
boolean |
true lists trashed folders instead.
Defaults to false
|
Request
curl https://api.veruapis.com/v1/file-folders \
-H "Authorization: Bearer vak_live_..."Response
| Field | Type | Description |
|---|---|---|
id |
string | |
name |
string | |
parent_id |
string | Empty for a folder at the root. |
owner_id |
string | |
trashed |
boolean | |
created_at |
RFC 3339 | |
updated_at |
RFC 3339 |
{
"data": [
{ "id": "0192f001-0000-7a41-b8d2-5e9f0c3a7b41", "name": "Reports", "parent_id": "", "owner_id": "01918e4b-7c2e-7f11-b4a9-0242ac130003", "trashed": false, "created_at": "2026-08-01T09:00:00Z", "updated_at": "2026-08-01T09:00:00Z" },
{ "id": "0192f002-0000-7a41-b8d2-5e9f0c3a7b41", "name": "Q3", "parent_id": "0192f001-0000-7a41-b8d2-5e9f0c3a7b41", "owner_id": "01918e4b-7c2e-7f11-b4a9-0242ac130003", "trashed": false, "created_at": "2026-08-02T09:00:00Z", "updated_at": "2026-08-02T09:00:00Z" }
],
"meta": { "request_id": "req_01j8z9...", "timestamp": "2026-09-02T10:00:00Z" },
"pagination": { "next_cursor": "eyJ1aWQiOjQyMTF9", "has_more": true, "limit": 25 }
}
Worth knowing
A flat list with parent ids rather than a nested tree, so you can build whichever shape you need without this API deciding the depth. file-folders, not folders, because /v1/folders is mail's.
Errors
Every failure uses the same shape, with a stable string code you can branch on. See the error reference.
Related
- DELETE Abort an upload
- POST Complete an upload
- POST Create a folder
- POST Start an upload
- DELETE Delete a file
- DELETE Delete a folder
- GET Download a file
- GET Get file metadata
- GET Get upload status
- GET List files
- GET List file permissions
- POST Share a file
- DELETE Revoke file access
- PATCH Rename or move a file
- PATCH Rename or move a folder
- PUT Upload a part