# API REST

> Automatize tudo o que você faz no painel com a API REST da W8 Hub — ideal para CI/CD, scripts e agentes de IA. Referência interativa completa.

_Fonte: https://w8hub.com.br/docs/api-rest_

Tudo o que você faz no painel também roda pela **API REST**, na base `https://api.w8hub.com.br/v1` — ideal para CI/CD, automações e agentes de IA. São mais de 170 endpoints cobrindo projetos, instalações, deploys, bancos, domínios, integrações, observabilidade e time.

## Autenticação

Crie um [token de API](https://w8hub.com.br/docs/tokens-de-api) na organização e envie no header `Authorization`. Exemplo — listar suas instalações:

```
curl https://api.w8hub.com.br/v1/resources/ \
  -H "Authorization: Bearer w8_seu_token_aqui"
```

## Exemplos comuns

Disparar um deploy de uma instalação:

```
curl -X POST https://api.w8hub.com.br/v1/resources/{id}/deployments/ \
  -H "Authorization: Bearer w8_seu_token_aqui"
```

Criar uma instalação a partir de um repositório GitHub público, buildando com [Nixpacks](https://w8hub.com.br/docs/implantacoes#modos-de-build) (sem Dockerfile):

```
curl -X POST https://api.w8hub.com.br/v1/resources/public-github \
  -H "Authorization: Bearer w8_seu_token_aqui" \
  -H "Content-Type: application/json" \
  -d '{
    "projectId": "proj_123",
    "name": "minha-api",
    "gitRepository": "https://github.com/acme/minha-api",
    "gitBranch": "main",
    "buildMode": "nixpacks",
    "generateDomain": true,
    "instantDeploy": true
  }'
```

## Áreas da API

Os endpoints seguem as mesmas áreas do painel:

| Área | Base do endpoint |
| --- | --- |
| Projetos | `/v1/projects` |
| Instalações | `/v1/resources` |
| Deploys | `/v1/resources/{id}/deployments` |
| Variáveis de ambiente | `/v1/resources/{id}/envs` |
| Logs | `/v1/resources/{id}/logs` |
| Proxy | `/v1/resources/{id}/proxy` |
| Bancos de dados | `/v1/databases` |
| Domínios | `/v1/domains` |
| Armazenamento S3 | `/v1/storage/buckets` |
| Integrações | `/v1/organizations/{orgId}/integrations` |
| Webhooks | `/v1/organizations/{orgId}/webhooks` |
| Tokens de API | `/v1/api-tokens/{orgId}` |
| Observabilidade | `/v1/monitoring`, `/v1/alerts`, `/v1/organizations/{orgId}/incidents` |
| Time e organização | `/v1/organizations` |

A referência interativa completa (todos os endpoints, campos e respostas) está abaixo:

<div class="docs-cards">
<a class="docs-card" href="https://api.w8hub.com.br/docs">
<span class="ic">📖</span>
<b>Documentação da API →</b>
<span>Referência interativa completa em <code>api.w8hub.com.br/docs</code>.</span>
</a>
<a class="docs-card" href="ia">
<span class="ic">🤖</span>
<b>Guia para agentes de IA →</b>
<span>Como uma IA conectada à conta opera a W8 Hub pela API.</span>
</a>
</div>