Get knowledge folder structure with note counts.

Return the full folder tree with per-folder note counts.

GET /v3/organizations/{org_id}/knowledge/folders

Get knowledge folder structure with note counts.

cURL

curl --request GET \
  --url https://api.devin.ai/v3/organizations/{org_id}/knowledge/folders \
  --header 'Authorization: Bearer <token>'

200

{
  "folders": [
    {
      "folder_id": "<string>",
      "name": "<string>",
      "note_count": 123,
      "path": "<string>",
      "parent_folder_id": "<string>"
    }
  ],
  "root_note_count": 123
}

Permissions

Requires a service user with the ManageKnowledge permission at the organization level.

Authorizations

Authorization · string · header · required

Service User credential (prefix: cog_)

Response

200 - application/json

Successful Response

Response for the folder-structure endpoint.

folders · FolderSummary · object[] · required

Show child attributes

root_note_count · integer · required