---
title: "Create an alert history entry"
method: POST
path: "/api/alerts/history"
tags: ["Alerts"]
---

# Create an alert history entry

`POST /api/alerts/history`

## Request

- Base URL: `https://demo.supercheck.dev`
- URL: `https://demo.supercheck.dev/api/alerts/history`
- Auth: HTTP bearer

Record an alert event (for example a manually created failure or recovery signal). Requires monitor manage permission.

## Request body

- object
  - `type` string, required
  - `message` string, required
  - `target` string, required
  - `targetType` string, required
  - `provider` string, required
  - `status` string, nullable
  - `monitorId` string, uuid, nullable
  - `jobId` string, uuid, nullable
  - `errorMessage` string, nullable

## Response `201`

Alert history entry created

- AlertHistoryEntry
  - `id` string, uuid
  - `targetType` string
  - `targetId` string
  - `targetName` string
  - `type` string
  - `message` string
  - `status` string
  - `timestamp` string, date-time
  - `notificationProvider` string
  - `metadata` object
    - `errorMessage` string, nullable

## Other responses

- `400`: Missing required fields
- `401`: Authentication required or token invalid
- `403`: Insufficient permissions
- `500`: Internal server error

## Changes

- **2026-09-15** `27d0aac76359`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/supercheck-io/apis/supercheck-api/changes/api/alerts/history/post.md)

---

[API](https://skmtc.dev/supercheck-io/apis/supercheck-api.md) - [All operations](https://skmtc.dev/supercheck-io/apis/supercheck-api/llms.txt) - [OpenAPI document](https://skmtc.dev/supercheck-io/apis/supercheck-api/revisions/7fa0162c07bd?raw)