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

> Altera o papel de um membro ou a data de expiração do acesso. Exige `members:manage`.

Exige a permissão `members:manage`. Uma chave de API precisa do escopo `workspaces:write`.

> [!NOTE]
>
> Ninguém consegue editar a própria linha de membro por este endpoint — nem para alterar o próprio
> `expires_at`. Sem isso, `members:manage` poderia remover a própria expiração e se tornar permanente por conta própria.

### Caminho

**id** `string` *required*

ID do workspace.

**user\_id** `string` *required*

ID do usuário do membro.

### Corpo

Pelo menos um campo é obrigatório.

**role\_id** `string`

Novo ID de papel, que precisa pertencer a este workspace.

**expires\_at** `string | null`

Data e hora em ISO, ou `null` para remover a expiração.

### Resposta

Mesmo formato de uma linha de [Listar membros](https://docs.vertracloud.app/pt-br/api-reference/endpoint/workspaces/members/list.md).

### Erros

| Status | Código | Quando |
| - | - | - |
| 400 | `VALIDATION_ERROR` | Nenhum campo enviado. |
| 403 | `WORKSPACE_PERMISSION_DENIED` | Quem chama não tem `members:manage`, ou está editando a própria linha. |
| 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.