List collections

List collections and sub-collections with your access level in each.

GET https://cotlet.dev/api/v1/bluedot/collections

read

Returns the collections you can see in the sidebar, nested ones with their parent_collection_id. Each row has your access (full_access, can_upload, can_view or no_access), whether it sends notes to Slack and the ID of its enforced notes template, if any. Collections you have no access to do not appear.

Parameters

Parameters: list_collections
NameTypeDescription
workspace_id string string Workspace ID from list_workspaces. Leave out to use your current workspace.
parent_collection_id string string Only the sub-collections of this collection. Leave out to list all.

Request

cURL
curl https://cotlet.dev/api/v1/bluedot/collections \
  -H "Authorization: Bearer $COTLET_API_KEY"
Python
result = client.call("bluedot", "list_collections")
Node.js
const result = await cotlet.call('bluedot', 'list_collections');
CLI
cotlet call bluedot list_collections

Example response

JSON

{
  "collections": [
    {
      "collection_id": "c_5d90e7a2",
      "title": "Customer calls",
      "parent_collection_id": null,
      "your_access": "full_access",
      "sends_notes_to_slack": true,
      "enforced_template_id": null
    },
    {
      "collection_id": "c_17f8b3d6",
      "title": "Sales demos",
      "parent_collection_id": null,
      "your_access": "can_upload",
      "sends_notes_to_slack": false,
      "enforced_template_id": "t_41c7a9f3"
    }
  ]
}

Sign in once. Your agent does the rest.

Sign up and add the apps you need. Free 7-day trial with 2,000 credits, no card needed.