Delete role

delete

https://api.doit.com/iam/v1/roles/{id}

Deletes a custom role. Preset roles cannot be deleted, and a role still assigned to users must be unassigned first. A service account of a parent tenant can delete a descendant tenant's role by setting X-Tenant-Id to that tenant's customer ID.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Responses

204

No Content - Role deleted.

Language

Credentials

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

400Bad Request - The role is a preset role.

401Unauthorized - Invalid API key.

403Forbidden - The client is not authorized to perform the request.

404Not Found - The role does not exist or belongs to another customer.

409Conflict - The role is still assigned to users.

500Internal Server Error - Something went wrong with the DoiT API server.