# Hookdeck Operator Events API

**Canonical:** https://apis.io/apis/hookdeck/hookdeck-operator-events-api/  
**Provider:** Hookdeck — https://apis.io/providers/hookdeck/  
**Base URL:** https://api.hookdeck.com/2025-07-01  
**Documentation:** https://hookdeck.com/docs/api

Hookdeck Operator Events API is one of 21 APIs that [Hookdeck](https://apis.io/providers/hookdeck/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Operator Events. The published artifact set on APIs.io includes an OpenAPI specification and API documentation.

Operator events are Outpost's own lifecycle and alerting stream: delivery failures, destinations being auto-disabled, retry exhaustion and tenant subscription changes. They are about the deployment, not about a tenant's traffic, so they are delivered to **operator event destinations** rather than to tenant destinations. An operator event destination is deployment-wide, is not owned by any tenant you create, and has the same shape as a tenant destination: any destination type listed by `GET /operator-events/destination-types`, with that type's `config` and `credentials`. The Operator Events API is only available on managed Outpost, and requires the Admin API Key. Self-hosted deployments configure the same thing through environment variables and a single sink. See the [Operator Events](https://hookdeck.com/docs/outpost/features/operator-events) feature page. **Available topics** | Topic | Trigger | |-------|---------| | `alert.destination.consecutive_failure` | Consecutive failure count reaches 50%, 70%, 90%, or 100% of `ALERT_CONSECUTIVE_FAILURE_COUNT` | | `alert.destination.disabled` | Destination auto-disabled at the 100% failure threshold | | `alert.attempt.exhausted_retries` | Delivery exhausts all retry attempts | | `attempt.success` | Every successful delivery attempt | | `attempt.failed` | Every failed delivery attempt, including retries | | `tenant.subscription.updated` | A destination was created, updated or deleted and the tenant's topics or destination count changed | A destination may subscribe to every topic with `["*"]`, but `attempt.success` and `attempt.failed` fire once per delivery attempt and will dominate volume. Prefer an explicit topic list. **Topics are derived from these destinations.** The union of every enabled operator event destination's `topics` is what the deployment subscribes to, which is why `PATCH /config` rejects `OPERATOR_EVENTS_TOPICS` with a 422: change the destinations and the configuration follows.

## Operations (14)

| Method | Path | Summary |
|---|---|---|
| GET | `/operator-events/destination-types` | List Operator Event Destination Type Schemas |
| GET | `/operator-events/destinations` | List Operator Event Destinations |
| POST | `/operator-events/destinations` | Create Operator Event Destination |
| GET | `/operator-events/destinations/{destination_id}` | Get Operator Event Destination |
| PATCH | `/operator-events/destinations/{destination_id}` | Update Operator Event Destination |
| DELETE | `/operator-events/destinations/{destination_id}` | Delete Operator Event Destination |
| PUT | `/operator-events/destinations/{destination_id}/enable` | Enable Operator Event Destination |
| PUT | `/operator-events/destinations/{destination_id}/disable` | Disable Operator Event Destination |
| GET | `/operator-events/events` | List Operator Events |
| GET | `/operator-events/events/{event_id}` | Get Operator Event |
| GET | `/operator-events/events/{event_id}/attempts` | List Attempts for an Operator Event |
| GET | `/operator-events/attempts` | List Operator Event Attempts |
| GET | `/operator-events/attempts/{attempt_id}` | Get Operator Event Attempt |
| POST | `/operator-events/retry` | Retry Operator Event Delivery |

## Machine-readable artifacts (2)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/hookdeck/refs/heads/main/openapi/hookdeck-operator-events-api-openapi.yml
- **Documentation** — https://hookdeck.com/docs/bulk-retries

## Other Hookdeck APIs (12)

- [Hookdeck Connections API](https://apis.io/apis/hookdeck/hookdeck-connections-api/)
- [Hookdeck Sources API](https://apis.io/apis/hookdeck/hookdeck-sources-api/)
- [Hookdeck Destinations API](https://apis.io/apis/hookdeck/hookdeck-destinations-api/)
- [Hookdeck Events API](https://apis.io/apis/hookdeck/hookdeck-events-api/)
- [Hookdeck Requests API](https://apis.io/apis/hookdeck/hookdeck-requests-api/)
- [Hookdeck Transformations API](https://apis.io/apis/hookdeck/hookdeck-transformations-api/)
- [Hookdeck Bookmarks API](https://apis.io/apis/hookdeck/hookdeck-bookmarks-api/)
- [Hookdeck Issues API](https://apis.io/apis/hookdeck/hookdeck-issues-api/)
- [Hookdeck Metrics API](https://apis.io/apis/hookdeck/hookdeck-metrics-api/)
- [Hookdeck Integrations API](https://apis.io/apis/hookdeck/hookdeck-integrations-api/)
- [Hookdeck Notifications API](https://apis.io/apis/hookdeck/hookdeck-notifications-api/)
- [Hookdeck Attempts API](https://apis.io/apis/hookdeck/hookdeck-attempts-api/)

## Tags

Operator Events

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/hookdeck/hookdeck-operator-events-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/hookdeck/.