List files
us.api.brault.app— follows the region selector in the top barFiles the key’s creator can see. Folders are never included. q runs the same keyword + natural-language search as the app and consumes the search rate bucket.
Authorization
apiKey API key from Settings → Developers
In: header
Query Parameters
1 <= value <= 10050Opaque cursor from a previous response.
Include files in every descendant folder.
falseKeyword and natural-language search. Consumes the search rate bucket.
length <= 500Comma-separated extensions, without the dot.
date-timedate-timeComma-separated user ids.
Bytes.
Bytes.
A URL-encoded JSON filter document (boards.md § 5). A condition may name a brandspace property or a board property; a board-property condition matches files through their membership on that property’s board. Combines with every other parameter with AND — which is why a top-level or filter cannot be sent together with uploaded_by, extensions, kind, min_size, max_size, created_after or created_before (400 validation_error).
length <= 4096"created_at"Value in
- "name"
- "size"
- "created_at"
"desc"Value in
- "asc"
- "desc"
Response Body
application/json
application/json
curl -X GET "https://example.com/v1/files"{ "object": "list", "has_more": true, "next_cursor": "string", "data": [ { "object": "file", "id": "string", "kind": "image", "name": "string", "extension": "string", "mime": "string", "size": 0, "status": "processing", "library_id": "string", "folder_id": "string", "external_url": "string", "duration_ms": 0, "resolution": "1920x1080", "created_at": "2019-08-24T14:15:22Z", "created_by_id": "string", "trashed_at": "2019-08-24T14:15:22Z", "thumbnail_url": "string", "version": { "count": 0, "active_number": 0, "active_id": "string" } } ]}