Remove Role
Use this API to remove a single role from a privilege.
Limited Availability
This API is only available as a very limited preview and is currently closed.
Resource URL
DELETE https://<subdomain>/api/1/privileges/:id/roles/:role_id
Header Parameters
Authorization required string | Set to Set Generate the access token with the API credential pair created using the scope required to call this API. Call this API using the |
Resource Parameter
id required string |
Set to the |
role_id required string |
Set to the |
Sample Response
- 204 No Content
- 401 Unauthorized
- 404 Not Found
The role was removed from the privilege.
Typically, this error indicates an invalid access token.
{
"statusCode": 401,
"name": "UnauthorizedError",
"message": "The request requires user authentication."
}
The privilege or role ID does not exist or has been removed.
{
"statusCode": 404,
"name": "NotFoundError",
"message": "The resource can't be found or the server has not found anything matching the Request-URI"
}
Sample Code
cURL
curl 'https://<subdomain>/api/1/privileges/<privilege_id>/roles/<role_id>' \
-X DELETE \
-H "Authorization: Bearer <access_token>"
Postman Collection
Replace sample variables indicated by {{ }}
with your actual values.
- Clicking Run in Postman button navigates to the page where you can fork the collection to your workspace. Forking the collection into your workspace will enable you to contribute to the source collection using pull requests. You can also view the collection in a public workspace if you like and even import a copy of the collection using the links present on the screen.
Have a Question?

Have a how-to question? Seeing a weird error? Ask us about it on StackOverflow.

Found a bug? Submit a support ticket.

Have a product idea or request? Share it with us in our Ideas Portal.