DELETE
/projects/{project_id}/roles/{role_id}Delete a project role
Deletes a custom role from a project. Use project_id and role_id to identify the project role to remove. A 200 response confirms deletion and identifies the deleted role.
project_idstringrequired
The unique identifier of the project containing the role.
role_idstringrequired
The unique identifier of the role to delete.
200Returns a deletion confirmation containing the `role.deleted` object type, the deleted role's identifier, and a boolean indicating whether it was deleted.
objectstringrequired
Always `role.deleted`.
idstringrequired
Identifier of the deleted role.
deletedbooleanrequired
Whether the role was deleted.
400Returned when the request parameters are invalid or the requested operation cannot be performed.
errorobjectrequired
403Returned when the caller does not have permission to delete the project role.
errorobjectrequired
Details about the permission error.
404Returned when the endpoint is unavailable or a requested resource cannot be found in the organization or project.
errorobjectrequired
429Returned when the request exceeds a rate limit.
errorobjectrequired
Error handling
A 400 is returned when the request parameters are invalid or the operation cannot be performed, and a 403 is returned when the authenticated user lacks permission. A 404 is returned when the endpoint is unavailable or a requested resource is not found; a 429 indicates that a rate limit was exceeded. The project_id path parameter and role_id path parameter must identify the project and role to delete.