Clerk API (unofficial showcase)
DELETE/directories/{directory_id}/group_role_mappings/{mapping_id}

Delete a directory group role mapping

Deletes a single directory group role mapping. Mappings can be deleted while group role mapping is disabled on the directory, but the change only takes effect once it is enabled.

2 parameters
directory_idstringrequired
The ID of the directory.
mapping_idstringrequired
The ID of the directory group role mapping to delete.

5 status codes
200A directory group role mapping was deleted.
objectstringrequired
String representing the object's type.
Allowed:directory_group_role_mapping
idstringrequired
The ID of the deleted directory group role mapping.
deletedbooleanrequired
Whether the directory group role mapping was successfully deleted.
Allowed:true
400Request was not successful
errorsarray<object>required
metaobjectoptional
clerk_trace_idstringoptional
401Authentication invalid
errorsarray<object>required
metaobjectoptional
clerk_trace_idstringoptional
403Authorization invalid
errorsarray<object>required
metaobjectoptional
clerk_trace_idstringoptional
404Resource not found
errorsarray<object>required
metaobjectoptional
clerk_trace_idstringoptional

Error handling

A 400 is returned: Request was not successful. A 401 is returned: Authentication invalid. A 403 is returned: Authorization invalid. A 404 is returned: Resource not found.