Episodes

Register a new-episode webhook endpoint

Registers an http(s) endpoint for episodes_available pushes (see the EpisodesAvailableEvent schema and the top-level webhooks section). The HMAC signing secret is returned exactly once. Pushes carry METADATA ONLY — bodies are pulled through GET /v1/episodes under the subscriber’s own scopes. Delivery is at-least-once. 404 until EPISODE_SUBSCRIPTIONS_ENABLED=1.

Required scope: brain:admin.

post/v1/episodes/subscriptions

Request

  • Base URL: https://brain.inite.ai
  • URL: https://brain.inite.ai/v1/episodes/subscriptions
  • Auth: HTTP bearer

Request body

urlstring required

Response

Registered; store the secret now.

idstring required
secretstring required
watermarkstring required

Changes

No recorded changes to this operation across all 1 revision of this API.