# Atualizar nome da instância

`POST /instance/updateInstanceName`

Pasta: **Instancia**

## Autenticação

```http
token: {{token}}
```

## Descrição

# Atualizar nome da instância

Altera apenas o nome amigável da instância no painel/API (não muda o nome de perfil do WhatsApp).

Use para organizar instâncias em ambientes com vários números.

## Endpoint

```http
POST {{baseUrl}}/instance/updateInstanceName
```

## Autenticação

Header da instância:

```http
token: {{token}}
```

## Corpo da requisição

| Campo | Tipo | Obrigatório | Descrição |
| --- | --- | --- | --- |
| `name` | string | Sim | Novo nome interno da instância. |

## Exemplo de Requisição

```bash
curl -X POST "{{baseUrl}}/instance/updateInstanceName" \
  -H "token: {{token}}" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "Suporte N1"
}'
```

## Resposta de Sucesso

```json
{
  "success": true,
  "instance": {
    "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "name": "Suporte N1",
    "status": "connected"
  }
}
```

## Erros comuns

- `401` — header `token` ausente ou inválido
- `400` — JSON inválido ou campo `name` ausente no bind
- `500` — falha ao persistir no banco

## Corpo (exemplo)

```json
{
  "name": "Suporte N1"
}
```

## cURL

```bash
curl -X POST "{{baseUrl}}/instance/updateInstanceName" \
  -H "token: {{token}}" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "Suporte N1"
}'
```

---

[Índice da pasta](./index.md) · [Índice geral](../index.md) · [UI](https://gozap.dev/docs?op=instancia/atualizar-nome-da-instancia)