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.
Updated 13 days ago