Folders API

Create a Folder inside of a Collection

POST https://api.getguru.com/api/v1/folders/{homeBoardSlug}/action

You can find the homeBoardSlug in the response body of the Find Collection by ID API call.

Request Body:

{
  "actionType": "add",
  "folderEntries": [
    {
      "description": null,
      "entryType": "folder",
      "title": "Folder Name Goes Here"
    }
  ],
  "prevSiblingItemId": "first"
}

Note: The prevSiblingItemId field is used to determine where the new folder is placed. If you want it to be the first folder inside of the collection, use first. If you want it to be after a specific folder, use that folderId instead.

Create a Folder inside of a Folder

POST https://api.getguru.com/api/v1/folders/{parentFolderId}/action

Request Body:

{
  "actionType": "add",
  "folderEntries": [
    {
      "description": null,
      "entryType": "folder",
      "title": "Folder Name Goes Here"
    }
  ],
  "prevSiblingItemId": "first"
}

Note: The prevSiblingItemId field is used to determine where the new folder is placed. If you want it to be the first folder inside of the parent folder, use first. If you want it to be after a specific folder, use that folderId instead.

Move an existing Card to an existing Folder

POST https://api.getguru.com/api/v1/folders/{targetFolderId}/action

Request Body:

{
  "actionType": "move",
  "folderEntries": [
    {
      "entryType": "card",
      "id": "{cardId}"
    }
  ],
  "prevSiblingItemId": "first"
}

Note: The prevSiblingItemId field is used to determine where the card is placed. If you want it to be the first card inside of the new folder, use first. If you want it to be after a specific card, use that cardId instead.