Referência da API

Canais

Um canal é um destino de entrega para eventos. Registre um canal de webhook para receber eventos em tempo real, ou outros tipos de canal para notificações.

O campo type é um dentre webhook, email, whatsapp, telegram, slack, mcp_push, in_app ou newsletter_digest. O formato de config depende do tipo — veja Webhooks para a configuração de webhook e o modelo de assinatura.

GET/v1/channels

Listar canais

Retorna todos os canais de entrega desta assinatura.

Requisição

curl https://gabinete360.ia.br/api/v1/channels \
  -H "Authorization: Bearer argos_ak_live_••••••"

Resposta

200 OK

[
  {
    "id": "d34d…",
    "subscriptionId": "b21e…",
    "projectId": null,
    "type": "webhook",
    "label": "Production webhook",
    "config": {
      "type": "webhook",
      "url": "https://your-app.com/argos/webhook",
      "secret": "whsec_••••••"
    },
    "isActive": true,
    "createdAt": "2026-05-24T18:30:00.000Z"
  }
]

POST/v1/channels

Criar um canal

Registra um novo canal de entrega. O objeto config é validado por tipo na camada de serviço.

Parâmetro	Tipo	Descrição
`type`obrigatóriobody	ChannelType	O tipo de canal de entrega, por exemplo "webhook".
`config`obrigatóriobody	object	Configuração específica do tipo. Para webhook: { url, secret }.
`name`opcionalbody	string \| null	Um rótulo para o canal.

Requisição

curl -X POST https://gabinete360.ia.br/api/v1/channels \
  -H "Authorization: Bearer argos_ak_live_••••••" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "webhook",
    "name": "Production webhook",
    "config": {
      "type": "webhook",
      "url": "https://your-app.com/argos/webhook",
      "secret": "whsec_your_signing_secret"
    }
  }'

Resposta

200 OK

{
  "id": "d34d…",
  "subscriptionId": "b21e…",
  "projectId": null,
  "type": "webhook",
  "label": "Production webhook",
  "config": {
    "type": "webhook",
    "url": "https://your-app.com/argos/webhook",
    "secret": "whsec_••••••"
  },
  "isActive": true,
  "createdAt": "2026-05-24T18:30:00.000Z"
}

PATCH/v1/channels/{id}

Ativar ou desativar um canal

Alterna se um canal recebe eventos. Envie isActive: false para pausar a entrega.

Parâmetro	Tipo	Descrição
`id`obrigatóriopath	uuid	O ID do canal.
`isActive`obrigatóriobody	boolean	Se o canal deve receber eventos.

Requisição

cURL

curl -X PATCH https://gabinete360.ia.br/api/v1/channels/d34d… \
  -H "Authorization: Bearer argos_ak_live_••••••" \
  -H "Content-Type: application/json" \
  -d '{"isActive": false}'

Resposta

200 OK

{ "success": true }

DELETE/v1/channels/{id}

Excluir um canal

Remove permanentemente um canal de entrega.

Parâmetro	Tipo	Descrição
`id`obrigatóriopath	uuid	O ID do canal.

Requisição

cURL

curl -X DELETE https://gabinete360.ia.br/api/v1/channels/d34d… \
  -H "Authorization: Bearer argos_ak_live_••••••"

Resposta

200 OK

{ "success": true }