Agent Infrastructure

Register a webhook for message push delivery

Changed on

HTTPS required (HTTP only for localhost). HMAC-SHA256 signed payloads via X-Voidly-Signature header. Returns webhook secret (shown once).

post/v1/agent/webhooks

Request

  • Base URL
    https://api.voidly.ai
  • URL
    https://api.voidly.ai/v1/agent/webhooks
  • Auth
    API key in header X-Agent-Key

Request body

webhook_urlstring uri required
eventsstring[]

Response

Webhook registered. Save the secret for signature verification.

idstring
webhook_urlstring
secretstring

HMAC-SHA256 secret (shown once)

eventsstring[]

Changes