> ## 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.

# Apagar papel

> Apaga um papel. Exige `roles:manage`; recusado enquanto estiver atribuído a um membro ou a um convite pendente.

Exige `roles:manage`. Uma chave de API precisa do escopo `workspaces:write`.

### Caminho

**id** `string` *required*

ID do workspace.

**role\_id** `string` *required*

ID do papel.

### Resposta

Resposta vazia em caso de sucesso.

### Erros

| Status | Código | Quando |
| - | - | - |
| 403 | `WORKSPACE_PERMISSION_DENIED` | Quem chama não tem `roles:manage`. |
| 404 | `WORKSPACE_NOT_FOUND` | O workspace não existe ou você não é membro. |
| 404 | `WORKSPACE_ROLE_NOT_FOUND` | O `role_id` não pertence a este workspace. |
| 409 | `WORKSPACE_ROLE_IN_USE` | Um membro tem este papel, ou existe um convite pendente com ele. Reatribua ou revogue antes. |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.