# Atualizar campos administrativos

`POST /instance/updateAdminFields`

Pasta: **Administração**

## Autenticação

```http
admintoken: {{adminToken}}
```

## Descrição

# Atualizar campos administrativos

Atualiza `adminField01` e `adminField02` de uma instância identificada pelo `token`. Use para gravar metadados do seu CRM/painel sem alterar a conexão WhatsApp.

## Endpoint

`POST {{baseUrl}}/instance/updateAdminFields`

## Autenticação

Envie o token de administrador no header `admintoken: {{adminToken}}`.

## Corpo da requisição

| Campo | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| `token` | string | Sim | Token da instância a atualizar. |
| `adminField01` | string | Não | Metadado administrativo. |
| `adminField02` | string | Não | Metadado administrativo. |

## Exemplo de Requisição

```bash
curl --request POST '{{baseUrl}}/instance/updateAdminFields' \
  --header 'admintoken: {{adminToken}}' \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "token": "{{token}}",
  "adminField01": "{{instanceName}}",
  "adminField02": ""
}'
```

## Resposta de Sucesso

```json
{
  "success": true
}
```

## Erros comuns

- `401 Unauthorized`: `admintoken` ausente ou inválido.
- `400 Bad Request`: JSON inválido ou `token` omitido.
- `500 Internal Server Error`: falha ao persistir os campos.

## Corpo (exemplo)

```json
{
  "token": "{{token}}",
  "adminField01": "{{instanceName}}",
  "adminField02": ""
}
```

## cURL

```bash
curl -X POST "{{baseUrl}}/instance/updateAdminFields" \
  -H "admintoken: {{adminToken}}" \
  -H "Content-Type: application/json" \
  -d '{
  "token": "{{token}}",
  "adminField01": "{{instanceName}}",
  "adminField02": ""
}'
```

---

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