List groups

What it does

Lists groups in a project for one hierarchy level. Without parentId, returns top-level groups. With parentId, returns direct children of that parent group.

Request

GET /api/v1/projects/{id}/groups

Auth	Required
Body	None

Path parameters

Name	Type	Description
id	string	Project id

Query parameters

Name	Type	Default	Description
limit	integer	100	Page size (1–100)
offset	integer	0	Number of items to skip
parentId	string	—	Parent group id; omit for root-level groups

Headers

Authorization: Bearer <your-api-key>

Example

curl -sS "https://collingo.app/api/v1/projects/clproj0123456789abcdefgh/groups?limit=50" \
  -H "Authorization: Bearer <your-api-key>"

Response

200 OK

{
  "limit": 50,
  "offset": 0,
  "total": 1,
  "result": [
    {
      "id": "clgroup0123456789abcdefg",
      "projectId": "clproj0123456789abcdefgh",
      "parentId": null,
      "technicalName": "pages",
      "displayName": "Pages",
      "createdAt": "2026-07-01T12:05:00Z"
    }
  ]
}

Errors

Status	When
400	Invalid query
401	Missing or invalid API key (ERR_UNAUTHORIZED)
403	Insufficient role (ERR_FORBIDDEN)
404	Project or parent not found
500	Database or internal error