GET /api/users/{id}/accessgroupmembership
List the named accessgroups a user is member of.
Description
Lists active access group memberships for a user. Query parameter `internal` controls filtering on `Ntg_Generell`: - `internal=true` => only internal groups (`Ntg_Generell = 0`) - `internal=false` => only non-internal groups (`Ntg_Generell = 1`) - missing `internal` => all active memberships - invalid `internal` value => fallback to non-internal groups (`Ntg_Generell = 1`) Examples: `/api/users/123/AccessGroupMembership?lookupField=gidid` `/api/users/123/AccessGroupMembership?lookupField=gidid&internal=true` `/api/users/123/AccessGroupMembership?lookupField=gidid&internal=false` `/api/users/123/AccessGroupMembership?lookupField=gidid&internal=abc`
Parameters
| Name | In | Description | Required | Type |
|---|---|---|---|---|
| id | path | User identifier value for lookupField (lookupField=Id uses GID id (gid_gidid) or login (Gid_Loginn)). | true | string |
| lookupField | query | Lookup field. Field to use when finding user. Possible values: Id (default), gidid and Code. | string | |
| internal | query | Optional filter for internal groups. true returns only internal (Ntg_Generell=0), false returns only non-internal (Ntg_Generell=1). Missing value returns all active memberships. Invalid values fall back to non-internal. | string |
Responses
| Code | Returns | Type |
|---|---|---|
| 200 | OK | Acos.Websak.UserAPI.Core.Models.AccessGroup[] |
| 401 | Unauthorized - Missing or invalid access token | |
| 403 | Forbidden - Provided access token does not permit usage of this API or data | |
| 500 | Internal Server Error |
Response Example
[{
"createdById":"string",
"fromDate":"string",
"general":"string",
"groupId":"string",
"groupName":"string",
"toDate":"string"
}]