DOC
/docs
Group endpoints
GET
/admin/applications/:applicationId/groups
List groups

Lists application groups.

Request

X-Tenant-ID: tenant-uuid
Authorization: Bearer <admin-jwt>

Response

{
  "groups": [
    {
      "id": 2,
      "key": "beta-testers",
      "name": "Beta testers"
    }
  ]
}
POST
/admin/applications/:applicationId/groups
Create group

Creates a reusable group. The key must be unique for the application.

Request

X-Tenant-ID: tenant-uuid
Authorization: Bearer &lt;admin-jwt&gt;

{ "key": "beta-testers", "name": "Beta testers" }

Response

{
  "group": {
    "id": 2,
    "key": "beta-testers",
    "name": "Beta testers"
  }
}
GET
/admin/applications/:applicationId/groups/:groupId
Get group

Returns one group by id.

Request

X-Tenant-ID: tenant-uuid
Authorization: Bearer <admin-jwt>

Response

{
  "group": {
    "id": 2,
    "key": "beta-testers",
    "name": "Beta testers"
  }
}
PATCH
/admin/applications/:applicationId/groups/:groupId
Update group

Updates group name or description.

Request

X-Tenant-ID: tenant-uuid
Authorization: Bearer &lt;admin-jwt&gt;

{ "description": "Early access users" }

Response

{
  "group": {
    "id": 2,
    "description": "Early access users"
  }
}
DELETE
/admin/applications/:applicationId/groups/:groupId
Delete group

Deletes a group only when it is not referenced by active flag rules.

Request

X-Tenant-ID: tenant-uuid
Authorization: Bearer <admin-jwt>

Response

204 No Content