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

# Atualizar papel

> Atualiza o nome ou as permissões de um papel. Exige `roles:manage`.

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

> [!NOTE]
>
> Mesma guarda de escalonamento de [Criar papel](https://docs.vertracloud.app/pt-br/api-reference/endpoint/workspaces/roles/create.md), mas verificada
> contra a **união dos conjuntos de permissões antigo e novo do papel**: remover uma permissão que você
> não tem de um papel de outra pessoa também é editar algo que não é seu. Ninguém — o dono incluído no
> espírito da regra, embora o dono esteja isento da verificação — pode editar o papel atualmente
> atribuído a si mesmo, e ninguém pode alterar a própria atribuição de papel por este endpoint.

### Caminho

**id** `string` *required*

ID do workspace.

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

ID do papel.

### Corpo

Substituição completa — mesmos campos de [Criar papel](https://docs.vertracloud.app/pt-br/api-reference/endpoint/workspaces/roles/create.md), todos obrigatórios exceto os opcionais.

**name** `string` *required*

**permissions** `WorkspacePermission[]` *required*

**position** `number`

### Resposta

Mesmo formato de [Criar papel](https://docs.vertracloud.app/pt-br/api-reference/endpoint/workspaces/roles/create.md).

### Erros

| Status | Código | Quando |
| - | - | - |
| 403 | `WORKSPACE_PERMISSION_DENIED` | Quem chama não tem `roles:manage`. |
| 403 | `WORKSPACE_PERMISSION_ESCALATION` | O conjunto de permissões antigo ou o novo inclui algo que quem chama não tem (quem não é dono). |
| 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. |


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