folder

Changed on

Moves an item to another folder. You must specify the folder ID of the destination folder, as well as the ID of the item you want to move.

NOTE: In some situations, a single item can exist in multiple folders. If you attempt to move an item that exists in multiple folders, the API returns an item_in_multiple_folders error. In this case, you must use the Canva UI to move the item to another folder.

post/v1/folders/move

Request

  • Base URL: https://api.canva.com/rest
  • URL: https://api.canva.com/rest/v1/folders/move
  • Auth: OAuth 2 (authorization code, authorization URL https://www.canva.com/api/oauth/authorize, token URL https://api.canva.com/rest/v1/oauth/token, scopes: folder:write)

Request body

to_folder_idstring required

The ID of the folder you want to move the item to (the destination folder). If you want to move the item to the top level of a Canva user's projects, use the ID root.

item_idstring required

The ID of the item you want to move. Currently, video assets are not supported.

Example request

{
  "to_folder_id": "FAF2lZtloor",
  "item_id": "Msd59349ff"
}

Response

OK

Changes

  • 40ca7f6a753bRevision changes
    • warning

      added the new user_linked_to_another_idp enum value to the response property for the response status

    • warning

      added the new user_linked_to_another_idp enum value to the response property for the response status

    • warning

      added the new user_linked_to_another_idp enum value to the response property for the response status

    • warning

      added the new user_linked_to_another_idp enum value to the response property for the response status

  • 5ea5a3f48e72Revision changes
    • warning

      added the new asset_not_ready enum value to the response property for the response status

    • warning

      added the new asset_not_ready enum value to the response property for the response status

    • warning

      added the new asset_not_ready enum value to the response property for the response status

    • warning

      added the new asset_not_ready enum value to the response property for the response status