Delete an unwanted Okta group of OKTA_GROUP or APP_GROUP type by executing a DELETE request via the Okta Groups API. Use an API client, such as Postman, to run the Remove Group API call and remove the specified group from the organization.

• Okta Identity Engine (OIE)
• Okta Classic Engine
• Application Programming Interface (API)
• Okta API
• Groups
• Postman

How is an unwanted group deleted via the Okta API?

Delete an unwanted group by installing an API client, downloading the Okta API collections, and executing the Remove Group API call as detailed in either the video demonstration or the written instructions. Postman is used as an example API client; use a tool that best fits the organization's guidelines.

1. Install Postman and integrate it with Okta.
2. Download the desired collections.
3. Run the List Groups API call under the Groups collection to locate the group and copy the group ID.
4. Select the Remove Group API call.
5. Replace {{groupId}} with the copied group ID in the following endpoint:

   DELETE {{url}}/api/v1/groups/{{groupId}}

6. Select Send.

NOTE: It is not possible to remove groups of APP_GROUP type if they are used in a group push mapping.

Related References

• Download and install Postman
• Test the Okta REST APIs using Postman
• Import a Postman Collection
• Okta Groups API Collection