Create a group

What it does

Creates a group in a project. Omit parentId (or send null) for a top-level group. The technical name must be unique among siblings under the same parent.

Request

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


Auth	Required
Query parameters	None

Path parameters

Name	Type	Description
`id`	string	Project id

Headers

Authorization: Bearer <your-api-key>
Content-Type: application/json

Body

{
  "technicalName": "footer",
  "displayName": "Footer",
  "parentId": "clgroup0123456789abcdefg"
}

Field	Type	Required	Description
`technicalName`	string	yes	Machine-readable name (camelCase-style)
`displayName`	string	yes	Human-readable label
`parentId`	string \| null	no	Parent group id; omit/`null` for root

Example

curl -sS https://collingo.app/api/v1/projects/clproj0123456789abcdefgh/groups \
  -H "Authorization: Bearer <your-api-key>" \
  -H "Content-Type: application/json" \
  -d '{
    "technicalName": "footer",
    "displayName": "Footer",
    "parentId": null
  }'

Response

200 OK

{
  "id": "clgroupaaaaaaaaaaaaaaaaaa",
  "projectId": "clproj0123456789abcdefgh",
  "parentId": null,
  "technicalName": "footer",
  "displayName": "Footer",
  "createdAt": "2026-07-01T12:10:00Z"
}

Errors

Status	When
`400`	Validation or hierarchy limit
`401`	Missing or invalid API key (`ERR_UNAUTHORIZED`)
`403`	Insufficient role (`ERR_FORBIDDEN`)
`404`	Project or parent not found
`409`	Duplicate technical name (`ERR_CONFLICT`)
`500`	Database or internal error