# Atualizar projeto

Fonte: https://apiwpp.com/docs/api/projetos/atualizar-projeto
Seção: Projetos
Atualizado em: 2026-09-28

`PATCH /tenants/{id}`

Atualiza a configuração de webhook do projeto: o endereço, o token, os cabeçalhos personalizados, o segredo de assinatura e o envio de `message.outgoing`. Só os campos enviados mudam, e a resposta é o projeto atualizado. Escopo necessário: `webhooks:write`.

## Cabeçalhos

| Nome | Obrigatório | Descrição |
| --- | --- | --- |
| `Authorization` | sim | `Bearer <chave de API>`; ou envie a chave em `X-Api-Key`. |
| `Content-Type` | sim | `application/json` |

## Parâmetros de caminho

| Nome | Tipo | Obrigatório | Descrição |
| --- | --- | --- | --- |
| `id` | `string · uuid` | sim | Identificador do projeto (`tenantId`). |

## Corpo da requisição

| Campo | Tipo | Obrigatório | Descrição |
| --- | --- | --- | --- |
| `name` | `string` | não | Nome do projeto. Só da plataforma: enviado com uma chave de API, a requisição responde `403` e nada muda. |
| `webhookBaseUrl` | `string · uri` | não | Endereço que recebe os eventos por `POST`. Conferido só quando muda: `https`, sem usuário e senha na URL, e o host precisa resolver só para endereços públicos; senão, `400`. Redirecionamentos nunca são seguidos: uma resposta `3xx` é uma entrega com falha. |
| `webhookToken` | `string` | não | Vai no cabeçalho `X-Webhook-Token` de toda entrega. Só de escrita: nunca volta nas respostas. |
| `webhookHeaders` | `object \| null` | não | Cabeçalhos personalizados enviados em toda entrega, por nome (`{"X-Crm-Account": "acme"}`). Substitui os anteriores; `null` remove todos. Podem substituir `Content-Type` e `X-Webhook-Token`, mas nunca os cabeçalhos de assinatura. Só de escrita: as respostas trazem só os nomes, em `webhookHeaderNames`. (chaves livres, valores string) |
| `webhookSecret` | `string \| null` | não | Segredo de assinatura das entregas: com ele, toda entrega também traz `X-Sales-Timestamp` e `X-Sales-Signature` (`sha256=` seguido do HMAC-SHA256 de `timestamp.corpo`). `null` ou `""` desliga a assinatura. Só de escrita: as respostas trazem só `hasWebhookSecret`. |
| `emitOutgoing` | `boolean` | não | Com `true`, o projeto também recebe [`message.outgoing`](https://apiwpp.com/docs/webhooks/message-outgoing) para cada mensagem 1:1 que o número envia: o eco de cada envio pela API e as mensagens digitadas no celular. Padrão do projeto: `false`. |
| `maxPerMinute` | `number \| null` | não | Limite próprio de envios por minuto de cada número do projeto, depois do aquecimento; `null` volta ao padrão do gateway. Só da plataforma: enviado com uma chave de API, a requisição responde `403` e nada muda. |
| `maxPerHour` | `number \| null` | não | Limite próprio de envios por hora de cada número do projeto; `null` volta ao padrão do gateway. Só da plataforma: enviado com uma chave de API, a requisição responde `403` e nada muda. |
| `maxPerDay` | `number \| null` | não | Limite próprio de envios por dia de cada número do projeto; `null` volta ao padrão do gateway. Só da plataforma: enviado com uma chave de API, a requisição responde `403` e nada muda. |
| `isActive` | `boolean` | não | Ativa ou desativa o projeto. Só da plataforma: enviado com uma chave de API, a requisição responde `403` e nada muda. |
| `planId` | `string \| null` | não | Plano da organização dona do projeto (a cobrança é da organização: todos os projetos dela mudam juntos); `null` remove o plano. Só da plataforma: enviado com uma chave de API, a requisição responde `403` e nada muda. |

## Exemplo de requisição

### cURL

```bash
curl -X PATCH \
  https://api.apiwpp.com/tenants/$TENANT_ID \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "webhookBaseUrl": "https://crm.example.com/api/whatsapp/events",
    "emitOutgoing": true
  }'
```

### Node.js

```javascript
const res = await fetch(`https://api.apiwpp.com/tenants/${tenantId}`, {
  method: 'PATCH',
  headers: {
    Authorization: `Bearer ${API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    webhookBaseUrl: 'https://crm.example.com/api/whatsapp/events',
    emitOutgoing: true,
  }),
})
const data = await res.json()
```

### PHP

```php
$response = Http::withToken($apiKey)
    ->patch("https://api.apiwpp.com/tenants/{$tenantId}", [
        'webhookBaseUrl' => 'https://crm.example.com/api/whatsapp/events',
        'emitOutgoing' => true,
    ]);
```

### Python

```python
import requests

response = requests.patch(
    f"https://api.apiwpp.com/tenants/{tenant_id}",
    headers={"Authorization": f"Bearer {API_KEY}"},
    json={
        "webhookBaseUrl": "https://crm.example.com/api/whatsapp/events",
        "emitOutgoing": True,
    },
)
```

## Respostas

| Código | Erro | Descrição |
| --- | --- | --- |
| 200 |  | O projeto atualizado, sem as credenciais do webhook. |
| 400 |  | O `webhookBaseUrl` foi recusado: precisa ser `https`, sem usuário e senha na URL, e o host precisa resolver só para endereços públicos. `error` diz qual regra falhou. |
| 400 | `FST_ERR_VALIDATION` | O corpo não segue o schema da operação (por exemplo, `emitOutgoing` que não é booleano), ou `id` não é um UUID; `message` diz o que está errado. |
| 401 |  | Sem chave de API, ou com uma chave desconhecida, revogada ou expirada. A chave de um projeto desativado também responde `401`. |
| 403 |  | A chave não tem o escopo `webhooks:write`; a mensagem de erro cita o escopo que falta. |
| 403 |  | O corpo traz um campo que só a plataforma muda (`name`, `planId`, `isActive`, `maxPerMinute`, `maxPerHour` ou `maxPerDay`); a mensagem lista quais. Nada muda. |
| 404 |  | O projeto não existe ou não é de quem chama (`Tenant not found`): uma chave de API alcança só o próprio projeto, e o de outra pessoa responde igual a um que não existe. |
| 409 |  | A requisição veio de uma aba antiga do painel, aberta no navegador, que sobrescreveria `webhookToken` e `webhookHeaders`: recarregue a página e tente de novo. Chamadas de servidor para servidor nunca recebem este `409`. |
| 429 |  | Requisições demais deste IP de origem, ou autenticações com falha demais: espere os segundos de `Retry-After`. Veja [Limites](https://apiwpp.com/docs/referencia/limites). Cabeçalhos: `Retry-After`. |

### 200 OK

```json
{
  "id": "3f6c2a8e-9d41-4b7a-8c15-2e7d9a0b4c61",
  "organizationId": "2d5e8a1b-4c7f-4e9a-8b3d-6f0a2c4e8b1d",
  "name": "acme-crm",
  "webhookBaseUrl": "https://crm.example.com/api/whatsapp/events",
  "webhookHeaderNames": [
    "X-Crm-Account"
  ],
  "emitOutgoing": true,
  "maxPerMinute": null,
  "maxPerHour": null,
  "maxPerDay": null,
  "hasWebhookSecret": true,
  "planId": "b7e2c9d4-1f3a-4c5b-8d6e-9f0a1b2c3d4e",
  "subscriptionStatus": "active",
  "trialEndsAt": null,
  "currentPeriodEnd": "2026-10-24T12:00:00.000Z",
  "isActive": true,
  "createdAt": "2026-09-01T12:00:00.000Z",
  "updatedAt": "2026-09-24T12:00:00.000Z"
}
```

## Detalhes

`name`, `planId`, `isActive` e os limites `maxPerMinute`, `maxPerHour` e `maxPerDay` são só da plataforma: se algum deles vier com uma chave de API, a requisição inteira responde `403` e nada muda.

O token, os cabeçalhos e o segredo são só de escrita: nunca voltam nas respostas, que trazem `hasWebhookSecret` e `webhookHeaderNames`. As próximas entregas das conexões do projeto já usam os valores novos. Antes de trocar o endereço, teste-o com [`POST /tenants/webhook-test`](https://apiwpp.com/docs/api/projetos/testar-webhook).

Guia: [Projetos e conexões](https://apiwpp.com/docs/guias/projetos-e-conexoes).
