Folders API

📘

/boards Endpoint Deprecated

We’ve removed the /boards endpoint as part of an update to our content model. Boards have been replaced by folders, which are now accessible via the new /folders endpoint.

This change isn’t just a rename — folders are built on a newer, more robust underlying technology that provides better performance, scalability, and long-term flexibility than boards. We recommend updating any existing integrations to use /folders going forward.

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.