# Listar todas as instâncias

`GET /instance/all`

Pasta: **Administração**

## Autenticação

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

## Descrição

# Listar todas as instâncias

Retorna todas as instâncias do tenant. Use para inventário, painéis admin e para descobrir `id`/`token` de instâncias existentes.

## Endpoint

`GET {{baseUrl}}/instance/all`

## Autenticação

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

## Exemplo de Requisição

```bash
curl --request GET '{{baseUrl}}/instance/all' \
  --header 'admintoken: {{adminToken}}'
```

## Resposta de Sucesso

```json
{
  "success": true,
  "instances": [
    {
      "id": "uuid-da-instancia",
      "name": "minha-instancia",
      "status": "connected",
      "token": "inst_abc123",
      "connection_mode": "companion",
      "proxy_mode": "dynamic",
      "proxy_enabled": true
    }
  ]
}
```

## Erros comuns

- `401 Unauthorized`: `admintoken` ausente ou inválido.
- `500 Internal Server Error`: falha ao consultar o banco de instâncias.

## Observações

- Detalhes internos de proxy dinâmico (URL/IP) são omitidos na resposta pública.

## cURL

```bash
curl -X GET "{{baseUrl}}/instance/all" \
  -H "admintoken: {{adminToken}}"
```

---

[Índice da pasta](./index.md) · [Índice geral](../index.md) · [UI](https://gozap.dev/docs?op=administracao/listar-todas-as-instancias)