Webhook

Event

Roark POSTs a JSON payload to every endpoint subscribed to one of the events listed below. Every payload uses the same envelope (event, version, timestamp, data); the event field is the discriminator that selects the matching data shape.

Acknowledge with any 2xx response within 10 seconds. Non-2xx responses and timeouts are retried with exponential backoff.

Events

  • call.analysis.completed
  • call.analysis.failed
  • call.analysis.cancelled
  • call.evaluation.completed
  • call.evaluation.failed
  • simulation.run_plan_job.started
  • simulation.run_plan_job.completed
  • simulation.run_plan_job.failed
  • simulation.run_plan_job.cancelled
  • simulation.job.started
  • simulation.job.completed
  • simulation.job.failed
  • simulation.job.cancelled
  • metric_collection.job.completed
  • metric_collection.job.failed
  • chat.analysis.completed
  • chat.analysis.failed
  • issue.opened
  • issue.resolved
postWebhookWebhook

Payload

OR
OR
OR
OR
OR
OR
OR
OR
OR
OR
OR
OR
OR
OR
OR
OR
OR
OR

Example payload

{
  "event": "call.analysis.completed",
  "version": "1.0",
  "timestamp": "2026-05-18T09:44:40.971Z"
}

Response

Acknowledged. Any 2xx response is treated as success.

Changes