List groups
GET/groups
Returns directory groups.
The list returns the default field set (distinguishedName, displayName, cn, sAMAccountName, objectSid, domain_fqdn, domain_netbios, access, isEntraId, isHybrid) plus the object id. Query-string filtering, advanced, select, sorting and paging work as for GET /users.
Required role: any authenticated user.
Request
Responses
- 200
- 400
- 401
- 403
A page of groups.
Response Headers
Number of records in this page.
Page size used for the request (limit).
Current page number.
Total number of pages.
Total number of records matching the query.
RFC 8288 links with rel values first, last, and, when they exist, prev and next.
Invalid query (unknown field or non-string value). Typed error body.
No token, or the token is invalid or expired. The body is {message}: No auth token provided when no token is sent, otherwise the token check's message (jwt expired, jwt malformed, invalid signature, invalid token, jwt signature is required). Send Authorization: Bearer <token> exactly: the server drops the first seven characters of the header and reads the rest as the token, so a different scheme or an extra space fails. If Authorization is absent, the server reads a token field in the body, then a token query parameter, then x-access-token. Routes that validate query fields reject ?token= with 400 InvalidQuery.
The token's role is not allowed for this operation, or the token's scopes exclude the route
(Scope not allowed by token).