Skip to content

List all groups

GET /api/v1/all-groups

GET /maas/api/v1/all-groups

Returns available Kubernetes/OpenShift group names for subscription and policy forms. Falls back to system:authenticated when the groups API is unavailable (for example BYOOIDC). K8s calls: GET /k8s/v1/groups

Authorization

Responses

Status Description Response body
200 OK

List of group names

object

application/json

401 Unauthorized

Unauthorized

None
500 Internal Server Error

Internal Server Error

ErrorResponse

application/json

200 OK response body

Property Type Required Description
data array of string Yes

Example request

curl -X GET "/maas/api/v1/all-groups" \
  -H "Authorization: Bearer $TOKEN"

Example response

200 OK, application/json

{
  "data": ["system:authenticated", "premium-users", "enterprise-users"]
}