POST /api/v1/directories/{appInstanceId}/groups/modify

Updates an AD Group membership directly in AD

Servers

Path parameters

Name Type Required Description
appInstanceId String Yes

ID of the AD AppInstance in Okta

Request headers

Name Type Required Description
Content-Type String Yes The media type of the request body.

Default value: "application/json"

Request body fields

Name Type Required Description
id String No

ID of the AD group to update

parameters Object No

Attributes used for processing AD Group membership update

parameters.values[] Array No

List of user IDs whose group memberships to update

parameters.action String No

The update action to take

Possible values:

  • "REMOVE"
  • "ADD"
parameters.attribute String No

The attribute that tracks group memberships in AD. This should be member for AD.

How to start integrating

  1. Add HTTP Task to your workflow definition.
  2. Search for the API you want to integrate with and click on the name.
    • This loads the API reference documentation and prepares the Http request settings.
  3. Click Test request to test run your request to the API and see the API's response.