Ingest an alert

POST

/api/ingest

Pushes one alert. Alerts are fingerprinted on source + title + severity:
if an open alert with the same fingerprint exists, its occurrence counter is
incremented instead of creating a new row (meta.is_duplicate: true), and
notifications fire at thresholds 1, 10, 25, 50, 100.

Request

Authorization

API Key

Add parameter in header

X-Api-Key

Example:

X-Api-Key: ********************

Body Params application/jsonRequired

Examples

Responses

🟢201

application/json

Alert created or deduplicated into an existing open alert.

Bodyapplication/json

🟠400

🟠401Unauthorized

🟠429RateLimited

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.sigtake.com/api/ingest' \
--header 'X-Api-Key: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
    "title": "High CPU on web-01",
    "severity": "info",
    "source": "datadog-agent",
    "payload": {},
    "team_code": "PAY"
}'

Response Example

201 - Example 1

{
    "data": {
        "id": 0,
        "tenant_id": 0,
        "team_id": 0,
        "api_key_id": 0,
        "title": "string",
        "severity": "critical",
        "status": "firing",
        "source": "string",
        "fingerprint": "string",
        "occurrence_count": 0,
        "last_seen_at": "2019-08-24T14:15:22.123Z",
        "payload": {
            "property1": "string",
            "property2": "string"
        },
        "created_at": "2019-08-24T14:15:22.123Z",
        "updated_at": "2019-08-24T14:15:22.123Z",
        "resolved_at": "2019-08-24T14:15:22.123Z"
    },
    "meta": {
        "is_duplicate": true,
        "occurrence_count": 1
    }
}

Modified at 2026-07-18 23:37:11

Ingest signal readings