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

- [Documentação da API →](https://api.w8hub.com.br/docs) — Referência interativa completa em api.w8hub.com.br/docs.

- [Guia para agentes de IA →](https://w8hub.com.br/ia) — Como uma IA conectada à conta opera a W8 Hub pela API.