List groups
Get a list of groups within an organization
Authentication: personal access token. The spec defines an api_key security
scheme — send an Authorization: ApiKey <your-personal-access-token> header
(value format: ApiKey <your key>). A session_cookie scheme (connect.sid)
exists for browser sessions. Operations in this spec declare security: [], an
artifact of the upstream spec generator — authentication is still enforced by the
server.
Query parameters
| Name | Type | Required | Description |
|---|---|---|---|
filter | string | No | Filter to apply to the group list (optional) |
startIndex | number | No | Index of the first group to return (optional) |
count | number | No | Number of groups to return (optional) |
Responses
200 — Ok
{
"schemas": [
"urn:ietf:params:scim:api:messages:2.0:ListResponse"
],
"totalResults": 0,
"itemsPerPage": 0,
"startIndex": 0,
"Resources": [
{
"schemas": [
"string"
],
"id": "string",
"meta": {
"version": "string",
"location": "string",
"lastModified": "2024-01-01T00:00:00.000Z",
"created": "2024-01-01T00:00:00.000Z",
"resourceType": "Group"
},
"displayName": "string",
"members": [
{
"value": "string",
"display": "string"
}
]
}
]
}