List groups
Returns groups the caller has access to. Filter by group type, tenant, or search by name. Results include each group's member count and the caller's permission flags (canEdit, canDelete, canManageMembers).
Authorization
BearerAuth A project-scoped access token. Generate one via the Token API with your project ID and project secret.
In: header
Query Parameters
Filter by group type. Use all or omit to return both types.
"ORG_GROUP" | "TENANT_GROUP" | "all"Case-insensitive filter applied to group names.
Return only tenant groups belonging to this tenant.
Set to me to return only the groups you created.
"me"When true, include full member details in each group object.
One-based page number.
1 <= valueMaximum number of groups per page (default 20, max 100).
1 <= value <= 100Sort field.
"name" | "created" | "members"Sort direction.
"asc" | "desc"Response Body
application/json
application/json
application/json
application/json
application/json
curl -X get "https://semaphor.cloud/api/management/v1/groups"{
"groups": [
{
"id": "string",
"name": "string",
"description": "string",
"type": "ORG_GROUP",
"organizationId": "string",
"tenantId": "string",
"createdBy": "string",
"createdAt": "2019-08-24T14:15:22Z",
"updatedAt": "2019-08-24T14:15:22Z",
"memberCount": 0,
"permissions": {
"canEdit": true,
"canDelete": true,
"canManageMembers": true
}
}
],
"total": 0,
"page": 0,
"limit": 0,
"hasMore": true
}{
"error": "string",
"details": "string",
"code": "string",
"fieldErrors": [
{
"field": "string",
"message": "string"
}
]
}{
"error": "string",
"details": "string",
"code": "string",
"fieldErrors": [
{
"field": "string",
"message": "string"
}
]
}{
"error": "string",
"details": "string",
"code": "string",
"fieldErrors": [
{
"field": "string",
"message": "string"
}
]
}{
"error": "string",
"details": "string",
"code": "string",
"fieldErrors": [
{
"field": "string",
"message": "string"
}
]
}