List knowledge folders | Ara Documentation

The folder structure with note counts, derived from each note’s scope.

_{Scope: knowledge:read}

Authentication

AuthorizationBearer

Your ara_ API key from Settings > Ara API. Keys are capability-scoped: run, plugins:read, secrets:read, secrets:write, sessions:read, knowledge:read, repos:read, repos:write, reviews:read, reviews:write, analytics:read, org:read, org:write, attachments:read, attachments:write, plugins:write, guardrails:read, guardrails:write.

Path parameters

orgIdstringRequired

Organization id or slug. Resolve it with GET /v3/self.

Response

Folders.

itemslist of objects

totalinteger

1	{
2	"items": [
3	{
4	"folder_id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
5	"name": "Engineering Docs",
6	"note_count": 42
7	},
8	{
9	"folder_id": "a3bb189e-8bf9-3888-9912-ace4e6543002",
10	"name": "Product Specs",
11	"note_count": 15
12	},
13	{
14	"folder_id": "9c858901-8a57-4791-81fe-4c455b099bc9",
15	"name": "Team Meeting Notes",
16	"note_count": 27
17	}
18	],
19	"total": 3
20	}

$	curl https://api.ara.so/v3/organizations/orgId/knowledge/folders \
>	-H "Authorization: Bearer <token>" \
>	-H "Content-Type: application/json"