# On-Air event canceled

**Event:** `onair.event.canceled`

## Description

An On-Air event was canceled. Only the event's `id` and `title` are sent.

**Event name:** `onair.event.canceled`

**Required scope:** `onair:read`

Delivered inside the standard [event envelope](/docs/webhooks/webhooks#event-envelope);
the schema below shows the full delivery body with this event's payload
under `data`.

**Filter** on [`webhook.subscribe`](/docs/webhooks/webhook-subscribe).
Omit `filter` to receive every On-Air event.

```json
{
  "url": "https://example.com/hooks/onair",
  "event": "onair.event.canceled",
  "filter": { "eventId": "9f1c2d3e-4a5b-6c7d-8e9f-0a1b2c3d4e5f" }
}
```

## Webhook Payload


### Example Payload

```json
{
  "type": "onair.event.canceled",
  "eventId": "0197f9a9-81c8-7cc8-b29d-0e1f2a3b4c5d",
  "timestamp": "2026-06-25T16:45:00.000000Z",
  "apiVersion": "2026-07-07",
  "data": {
    "id": "9f1c2d3e-4a5b-6c7d-8e9f-0a1b2c3d4e5f",
    "title": "Product Launch"
  }
}
```

---

*Machine-readable API documentation.*
*Full documentation: https://developer.ro.am/docs/webhooks/onair-event-canceled*