> ## Documentation Index
> Fetch the complete documentation index at: https://docs.vertracloud.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Delete Role

> Deletes a role. Requires `roles:manage`; refused while it's assigned to a member or a pending invite.

Requires `roles:manage`. An API key needs the `workspaces:write` scope.

### Path

<ParamField path="id" type="string" required>Workspace ID.</ParamField>
<ParamField path="role_id" type="string" required>Role ID.</ParamField>

### Response

Empty response on success.

### Errors

| Status | Code                          | When                                                                                |
| ------ | ----------------------------- | ----------------------------------------------------------------------------------- |
| 403    | `WORKSPACE_PERMISSION_DENIED` | Caller lacks `roles:manage`.                                                        |
| 404    | `WORKSPACE_NOT_FOUND`         | Workspace doesn't exist or you're not a member.                                     |
| 404    | `WORKSPACE_ROLE_NOT_FOUND`    | `role_id` doesn't belong to this workspace.                                         |
| 409    | `WORKSPACE_ROLE_IN_USE`       | A member holds this role, or an invite pending on it exists. Reassign/revoke first. |