/v1/designs
GET {{baseUrl}}/v1/designs?query=<string>&continuation=<string>&ownership=<string>&sort_by=<string>
Lists metadata for all the designs in a Canva user's projects. You can also:
- Use search terms to filter the listed designs.
- Show designs either created by, or shared with the user.
- Sort the results.
Request Params
| Key | Datatype | Required | Description |
|---|---|---|---|
query | string | Lets you search the user's designs, and designs shared with the user, using a search term or terms. | |
continuation | string | If the success response contains a continuation token, the list contains more designs | |
| you can list. You can use this token as a query parameter and retrieve more | |||
| designs from the list, for example | |||
/v1/designs?continuation={continuation}. |
To retrieve all of a user's designs, you might need to make multiple requests. |
| ownership | string | | Filter the list of designs based on the user's ownership of the designs.
This can be one of the following:
-
owned: Designs owned by the user. -
shared: Designs shared with the user. -
any: Designs owned by and shared with the user. | |sort_by| string | | Sort the list of designs. This can be one of the following: -
relevance: (Default) Sort results using a relevance algorithm. -
modified_descending: Sort results by the date last modified in descending order. -
modified_ascending: Sort results by the date last modified in ascending order. -
title_descending: Sort results by title in descending order. -
title_ascending: Sort results by title in ascending order. |
HEADERS
| Key | Datatype | Required | Description |
|---|---|---|---|
Accept | string |
RESPONSES
status: OK
{"items":[{"id":"\u003cstring\u003e","owner":{"team_id":"\u003cstring\u003e","user_id":"\u003cstring\u003e"},"urls":{"edit_url":"\u003cstring\u003e","view_url":"\u003cstring\u003e"},"title":"\u003cstring\u003e","thumbnail":{"height":"\u003cinteger\u003e","url":"\u003cstring\u003e","width":"\u003cinteger\u003e"}},{"id":"\u003cstring\u003e","owner":{"team_id":"\u003cstring\u003e","user_id":"\u003cstring\u003e"},"urls":{"edit_url":"\u003cstring\u003e","view_url":"\u003cstring\u003e"},"title":"\u003cstring\u003e","thumbnail":{"height":"\u003cinteger\u003e","url":"\u003cstring\u003e","width":"\u003cinteger\u003e"}}],"continuation":"\u003cstring\u003e"}