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.completedcall.analysis.failedcall.analysis.cancelledcall.evaluation.completedcall.evaluation.failedsimulation.run_plan_job.startedsimulation.run_plan_job.completedsimulation.run_plan_job.failedsimulation.run_plan_job.cancelledsimulation.job.startedsimulation.job.completedsimulation.job.failedsimulation.job.cancelledmetric_collection.job.completedmetric_collection.job.failedchat.analysis.completedchat.analysis.failedissue.openedissue.resolved
WEBHOOK
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Body
application/json
- 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
Event name
Allowed value:
"call.analysis.completed"Example:
"call.analysis.completed"
Payload schema version
Allowed value:
"1.0"Example:
"1.0"
ISO 8601 timestamp when the webhook was generated
Example:
"2026-05-18T09:44:40.971Z"
Response
200
Acknowledged. Any 2xx response is treated as success.