List the workspace's workflow folders
workflow:readReturns a FLAT array of every folder in the caller's workspace, ordered case-insensitively by name. There is no nesting in the response — build the tree yourself from parentId (absent/null = a root folder).
workflowCount counts workflows filed DIRECTLY in that folder; it does not include workflows in descendant folders.
Folders organise workflows only; they have nothing to do with connections or templates, and a workflow's folder is set through the workflow API (folderId), not here.
An empty workspace returns {"data": []}.
Authorization
bearerAuth An API token: Authorization: Bearer grt_…. Mint one in the app under Settings → Workspace → API tokens; the raw value is shown once. Scopes confine the token — see x-permission on each operation.
In: header
Response Body
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/api/folders"{ "data": [ { "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "name": "string", "parentId": "70850378-7d3c-4f45-91b7-942d4dfbbd43", "workspaceId": "ef0efa32-d1c1-43d4-a5e2-fe7b4f00403c", "orgId": "25b2c2d5-a7fc-47d0-89e4-8709a1560bfa", "workflowCount": 0, "createdAt": "2019-08-24T14:15:22Z", "updatedAt": "2019-08-24T14:15:22Z" } ]}