How to find all governance groups an identity is a member of

There is a new filter parameter on the list governance groups endpoint that allows you to only return governance groups that an identity is a member of. We are in the process of documenting this new filter param, but the API call will look like this:

GET /beta/workgroups?filters=memberships.identityId eq "2c9180867624cbd7017642d8c8c81f67"

This will return a list of governance groups the identity is a member of. In my case, this user is a member of just one governance group.

[
    {
        "description": "Phil Governance Group 2",
        "owner": {
            "displayName": "Philip Ellis",
            "emailAddress": "[email protected]",
            "type": "IDENTITY",
            "id": "2c9180897d2cb80b017d39ccb26c1804",
            "name": "philip.ellis"
        },
        "memberCount": 4,
        "connectionCount": 4,
        "id": "b0c131fa-5133-4efb-9bb2-e22529f44cad",
        "name": "Phil Governance Group",
        "created": "2022-01-06T19:51:13Z",
        "modified": "2022-01-06T19:51:13Z"
    }
]

Listing the members of the above governance group shows that my user, colin.mckibben, is indeed a member of the group.

[
    {
        "email": "[email protected]",
        "type": "IDENTITY",
        "id": "2c9180837dfe6949017e208e26027b23",
        "name": "Jerry.Bennett"
    },
    {
        "email": "[email protected]",
        "type": "IDENTITY",
        "id": "2c918085840ffd5201841b62859f2d1f",
        "name": "Tyler"
    },
    {
        "email": "[email protected]",
        "type": "IDENTITY",
        "id": "2c9180867624cbd7017642d8c8c81f67",
        "name": "colin.mckibben"
    },
    {
        "email": "[email protected]",
        "type": "IDENTITY",
        "id": "2c9180897d2cb80b017d39ccb26c1804",
        "name": "Philip Ellis"
    }
]
9 Likes

This is a great improvement for sure. Are there any plans to include this specific information when getting the identities using for instance the search API or the get identity by id?

1 Like

No plans that Iā€™m aware of at this time. However, there are plans to add governance group membership to the identity UI so there may be enhancements to the identity API to make that more efficient.

1 Like

In what way will this be included in the UI that is different from the current UI for that? Do you mean that governance group membership is visible when viewing an Identity? If so and the APIs are there to support then I guess the answer to my previous comment would be yes?

1 Like

My understanding is that clicking on an identity to view their details in the UI will one day include their governance group memberships.

1 Like