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.

In every request below, the prevSiblingItemId field determines where the new item is placed within its destination. Use first to place it first, or pass an existing item's ID to place it immediately after that item.

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. (The field retains its legacy board naming.)

Request body:

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

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

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