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

# Actualizar miembro

> Cambia el rol o el vencimiento del acceso de un miembro. Requiere `members:manage`.

Requiere el permiso `members:manage`. Una clave de API necesita el scope `workspaces:write`.

> [!NOTE]
>
> Nadie puede editar su propia fila de pertenencia a través de este endpoint, ni siquiera para cambiar su propio
> `expires_at`. Sin esa regla, `members:manage` podría quitarse su propio vencimiento y volverse permanente por decisión
> unilateral.

### Ruta

**id** `string` *required*

ID del workspace.

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

ID de usuario del miembro.

### Body

Se requiere al menos un campo.

**role\_id** `string`

Nuevo ID de rol; debe pertenecer a este workspace.

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

Fecha y hora ISO, o `null` para quitar el vencimiento.

### Respuesta

Misma forma que una fila de [Listar miembros](https://docs.vertracloud.app/es-es/api-reference/endpoint/workspaces/members/list.md).

### Errores

| Estado | Código | Cuándo |
| - | - | - |
| 400 | `VALIDATION_ERROR` | No se envió ningún campo. |
| 403 | `WORKSPACE_PERMISSION_DENIED` | Quien llama no tiene `members:manage`, o está editando su propia fila. |
| 404 | `WORKSPACE_NOT_FOUND` | El workspace no existe o no eres miembro. |
| 404 | `WORKSPACE_ROLE_NOT_FOUND` | `role_id` no pertenece a este workspace. |


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