Get folder

Retrieve a folder's metadata.

Gets the name and other details of a folder using a folder's folderID.

GET https://api.canva.com/rest/v1/folders/{folderId}

This operation is rate limited to 100 requests per minute for each user of your integration.

This endpoint requires a valid access token that acts on behalf of a user. The token must have the following scopes (permissions):

  • folder:read

For more information, see Scopes.

#Authorizationstring
Required

Provides credentials to authenticate the request, in the form of a Bearer token.

For example: Authorization: Bearer {token}

#folderIdstring
Required

The folder ID.

Examples for using the /v1/folders/{folderId} endpoint:

curl --request GET 'https://api.canva.com/rest/v1/folders/{folderId}' \
--header 'Authorization: Bearer {token}'
sh

If successful, the endpoint returns a 200 response with a JSON body with the following parameters:

#folderFolder

The folder object, which contains metadata about the folder.

Properties of folder
#idstring

The folder ID.

#namestring

The folder name.

#created_atinteger

When the folder was created, as a Unix timestamp (in seconds since the Unix Epoch).

#updated_atinteger

When the folder was last updated, as a Unix timestamp (in seconds since the Unix Epoch).

#thumbnailThumbnail
Optional

A thumbnail image representing the object.

Properties of thumbnail
#widthinteger

The width of the thumbnail image in pixels.

#heightinteger

The height of the thumbnail image in pixels.

#urlstring

A URL for retrieving the thumbnail image. This URL expires after 15 minutes. This URL includes a query string that's required for retrieving the thumbnail.

{
"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>"
}
}
}
json

To get started, generate an access token or provide your own below