# Alert ingest API

Version 1.0 · OpenAPI 3.1.0

Send alerts into EvoHub On-Call from anything that can make an HTTP request.

- **Events** (`POST /ingest/api`) — trigger, acknowledge and resolve
  alerts with a small JSON body. Compatible with the Events v2 shape, so a
  tool that already speaks it only changes the URL and key.
- **Integration webhooks** (`POST /ingest/{type}`) — point a monitoring
  tool's own webhook at EvoHub; the body is whatever that tool sends.

Every request is authenticated by an **integration key**, shown as
**API Key** on the integration in On-Call → Integrations. The key decides
the organization and the escalation policy; nothing else in the request
can.

## Servers

- `https://evohub.io`

## Authentication

- `integrationKey`: API key in the query `key` — The integration key (the integration's API Key in On-Call → Integrations).
- `bearerKey`: HTTP Bearer — The integration key as a bearer token (`/ingest/api` only).

## Events

Trigger, acknowledge and resolve alerts by dedup key.

- [POST /ingest/api](https://docs-dev.evohub.io/alert-ingest/send-event.md): Send an event

## Integration webhooks

Native webhook payloads from monitoring tools.

- [POST /ingest/{type}](https://docs-dev.evohub.io/alert-ingest/send-integration-webhook.md): Receive a monitoring tool's webhook