Sign in

v3

latestOpenAPI 3.0.0©2023 All Rights Reserved2026-08-0659315450.0 KB
folder

Lists the items in a folder, including each item's type.

Folders can contain:

  • Other folders.

  • Designs, such as Instagram posts, Presentations, and Documents (Canva Docs).

  • Image assets.

  • Brand templates. To include brand_template items in the response, you must explicitly specify it in the item_types parameter.

    AVAILABILITY: Brand template items are only returned for users on a Canva plan with access to brand templates (such as Canva Pro, Canva Teams, or Canva Enterprise). For more information, see Brand templates.

Currently, video assets are not returned in the response.

get/v1/folders/{folderId}/items

Path parameters

folderIdstring required

The folder ID.

Query parameters

continuationstring

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.

limitinteger

The number of folder items to return.

item_typesFolderItemType[]

Filter the folder items to only return specified types. The available types are: design, folder, image, and brand_template. To filter for more than one item type, provide a comma-delimited list.

If not specified, defaults to returning design, folder, and image items. To include brand_template items, you must explicitly specify it in this parameter.

sort_by'created_ascending' | 'created_descending' | 'modified_ascending' | 'modified_descending' | 'title_ascending' | 'title_descending'

Sort the list of folder items.

pin_status'any' | 'pinned'

Filter folder items by their pinned status.

Filter the folder items by their pinned status.

Response

OK

continuationstring

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.

Example response

{
  "items": [
    {
      "folder": {
        "id": "FAF2lZtloor",
        "name": "My awesome holiday",
        "created_at": 1377396000,
        "updated_at": 1692928800,
        "thumbnail": {
          "width": 595,
          "height": 335,
          "url": "https://document-export.canva.com/Vczz9/zF9vzVtdADc/2/thumbnail/0001.png?<query-string>"
        }
      }
    }
  ],
  "continuation": "RkFGMgXlsVTDbMd:MR3L0QjiaUzycIAjx0yMyuNiV0OildoiOwL0x32G4NjNu4FwtAQNxowUQNMMYN"
}