Skip to main content

Delete Cloud Dynamic User Groups

DELETE 
/directory-sync/v1/cloud-dug-definition/group

Deletes a specific Cloud Dynamic User Group by objectGUID or all groups in a category by defID.

How it Works​

  • Use objectGUID to delete a specific group (obtained from POST create or GET list responses)
  • Use defID to delete all groups in a category (obtained from GET list response)
  • Provide either objectGUID or defID, but not both

Important Behavior​

The Application Programming Interface returns HTTP 200 even when deletion fails or is delayed.

Possible scenarios:​

  1. Sync in progress: If a data sync is currently running for the tenant, the deletion request is saved but not immediately executed. You'll need to retry later or wait for the next sync.
  2. Successful deletion: The group is deleted immediately and sync is scheduled.

Always check the result.sync and result.detail fields to determine the actual outcome:

  • "sync": "success" - Deletion completed
  • "sync": "Cloud Dynamic Group definition saved..." + "detail": "Data sync in-progress..." - Deletion pending, retry later.

Request​

Responses​

Delete request processed (does not guarantee immediate deletion).

Important: HTTP 200 does not mean the group was deleted. Check the response body:

  • If result.sync = "success", deletion completed
  • If result.detail contains "Data sync in-progress", deletion is pending and group was NOT deleted yet