/v1/folders/:folderId/items
GET {{baseUrl}}/v1/folders/:folderId/items?continuation=<string>&item_types=<string>
This API is currently provided as a preview. Be aware of the following:
- There might be unannounced breaking changes.
- Any breaking changes to preview APIs won't produce a new API version.
- Public integrations that use preview APIs will not pass the review process, and can't be made available to all Canva users.
Lists the items in a folder, including each item's type.
Folders can contain:
- Other folders.
- Assets, such as uploaded images and videos.
- Designs, such as Instagram posts, Presentations, and Documents (Canva Docs).
- Brand templates.
Request Params
| Key | Datatype | Required | Description |
|---|---|---|---|
continuation | string | If the success response contains a continuation token, the folder contains more items | |
| you can list. You can use this token as a query parameter and retrieve more | |||
| items from the list, for example | |||
/v1/folders/{folderId}/items?continuation={continuation}. |
To retrieve all the items in a folder, you might need to make multiple requests. |
| item_types | string | | Filter the folder items to only return specified types. The available types are:
asset, design, folder, and template. To filter for more than one item type,
provide a comma-delimited list. |
HEADERS
| Key | Datatype | Required | Description |
|---|---|---|---|
Accept | string |
RESPONSES
status: OK
{"items":[{"asset":{"created_at":"\u003clong\u003e","id":"\u003cstring\u003e","name":"\u003cstring\u003e","tags":["\u003cstring\u003e","\u003cstring\u003e"],"updated_at":"\u003clong\u003e","import_status":{"state":"failed","error":{"code":"file_too_big","message":"\u003cstring\u003e"}},"thumbnail":{"height":"\u003cinteger\u003e","url":"\u003cstring\u003e","width":"\u003cinteger\u003e"}},"type":"asset"},{"asset":{"created_at":"\u003clong\u003e","id":"\u003cstring\u003e","name":"\u003cstring\u003e","tags":["\u003cstring\u003e","\u003cstring\u003e"],"updated_at":"\u003clong\u003e","import_status":{"state":"in_progress","error":{"code":"file_too_big","message":"\u003cstring\u003e"}},"thumbnail":{"height":"\u003cinteger\u003e","url":"\u003cstring\u003e","width":"\u003cinteger\u003e"}},"type":"asset"}],"continuation":"\u003cstring\u003e"}