> ## Documentation Index
> Fetch the complete documentation index at: https://docs.roark.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 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`



## OpenAPI

````yaml /api-reference/openapi.documented.json webhook Webhook
openapi: 3.1.0
info:
  title: Roark Analytics API
  description: >-
    The Roark Analytics API gives you access to the same API that powers the
    award winning Roark Analytics platform.
  version: 1.0.0
servers:
  - description: Production
    url: https://api.roark.ai
security:
  - Bearer: []
tags:
  - name: Agent
  - name: Agent Endpoint
  - name: Call
  - name: Chat
  - name: Metric
  - name: Metric Policy
  - name: Metric Collection Job
  - name: Simulation Persona
  - name: Simulation Scenario
  - name: Simulation Run Plan
  - name: Simulation Run Plan Job
  - name: Simulation Job
  - name: HTTP Request Definition
  - name: Webhook
  - name: Issue
  - name: Knowledge Base
  - name: Call Analysis
  - name: Health
paths: {}
components:
  securitySchemes:
    Bearer:
      type: http
      scheme: bearer
      bearerFormat: JWT

````