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

> Atualiza o nome ou a descrição de um workspace. Somente o dono.

Somente o **dono** do workspace pode chamar isto — não é uma permissão, o `owner_id` é verificado
diretamente. Uma chave de API precisa do escopo `workspaces:write`. Recusado enquanto o plano do dono
estiver congelado (expirado ou rebaixado abaixo de Enterprise).

### Caminho

**id** `string` *required*

ID do workspace.

### Corpo

Mesmos campos de [Criar workspace](https://docs.vertracloud.app/pt-br/api-reference/endpoint/workspaces/create.md), todos opcionais — pelo menos um deve estar presente.

**name** `string`

De 1 a 50 caracteres.

**description** `string`

Até 200 caracteres.

### Resposta

Mesmo formato de [Obter workspace](https://docs.vertracloud.app/pt-br/api-reference/endpoint/workspaces/get.md).

### Erros

| Status | Código | Quando |
| - | - | - |
| 400 | `VALIDATION_ERROR` | Nenhum campo enviado. |
| 403 | `WORKSPACE_OWNER_ONLY` | Quem chama não é o dono. |
| 403 | `PLAN_RESTRICTED_FEATURE` | O plano do dono está congelado (expirado ou abaixo de Enterprise). |
| 404 | `WORKSPACE_NOT_FOUND` | O workspace não existe ou foi apagado de forma lógica. |
| 409 | `WORKSPACE_NAME_ALREADY_EXISTS` | Outro workspace ativo seu já tem este nome. |


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