UPDATE: The v2 APIs listed in this post are being deprecated. Please use the Beta APIs for managing governance groups.
A user recently asked if SailPoint has REST APIs for managing governance groups (AKA workgroups). We do, but they are undocumented v2 APIs. There is work being done by our engineers to bring more of our v1 and v2 APIs into v3, and workgroups is on the list. However, until workgroups makes it into v3, here are the details for managing workgroups using the v2 API:
GET /v2/workgroups (list all workgroups)
GET /v2/workgroups/{workgroupId}/members (list all members of a workgroup)
POST /v2/workgroups/{workgroupId}/members (Add and/or remove one or more members to a workgroup using their identity ID)
Body:
{
"add": [
"2c91808375d8e80a0175e1f88a575221"
],
"remove": []
}
POST /v2/workgroups (Create a new workgroup)
Body:
{
"name": "Test group 3",
"description": "This is a test",
"owner": {
"id": "2c9180867624cbd7017642d8c8c81f67"
}
}
PATCH /v2/workgroups/{workgroupId} (Update a workgroup)
Body:
{
"name": "Test group 3",
"description": "This is a test 2",
"owner": {
"id": "2c9180867624cbd7017642d8c8c81f67"
}
}
GET /v2/workgroups/{workgroupId}/connections (Get a list of associations for the governance group)
POST /v2/workgroups/bulk-delete (Delete one or more workgroups)
Body:
{
"ids": [
"868edef1-222b-40e4-8787-b56cfd78b100"
]
}