history API — Beaam reference
12 of Beaam's 119 capabilities: Past incidents, alerts sent, and detection statistics. Generated from the live capability manifest.
acknowledge-incident#
Acknowledge an incident — Mark an incident as being handled ("I'm on it"), or clear that. Quiets Beaam about it while you work on it.
auth requireddestructivemcp
| Field | Type | Required | Description |
|---|---|---|---|
incidentId | string | yes | The incident to acknowledge. |
acknowledged | boolean | no | True to acknowledge ("I'm on it"); false to clear it. |
add-incident-note#
Add a note to an incident — Record what happened on an incident — the cause, what was done, or what is still unknown. Notes are permanent and cannot be edited or deleted, so they keep what was believed at the time.
auth requiredmcp
| Field | Type | Required | Description |
|---|---|---|---|
incidentId | string | yes | The incident to annotate. |
body | string | yes | What happened, what was done, or what is still unknown. |
get-history-overview#
Get History overview — Return the active organization's bounded History page payload.
auth requiredread-only
Takes no input.
get-incident#
Get an incident — Fetch a single incident by id, with its current state and acknowledgement/snooze status.
auth requiredread-onlymcp
| Field | Type | Required | Description |
|---|---|---|---|
incidentId | string | yes | The incident to fetch. |
get-service-history#
Get service history — Return a service's complete retained-window uptime and latency summary, bounded chart series, latest check, and collapsed state runs.
auth requiredread-only
| Field | Type | Required | Description |
|---|---|---|---|
serviceId | string | yes | |
since | string | no |
list-alerts#
List alerts — Return the alerts Beaam has sent, newest first, with each alert's review state (real incident, false alarm, or unreviewed).
auth requiredread-onlymcp
| Field | Type | Required | Description |
|---|---|---|---|
unreviewedOnly | boolean | no | Only alerts not yet tagged real / false-alarm. |
limit | integer | no | Max rows, newest first (default 50, max 200). |
list-checks#
List checks — Return recent poll results (checks) for the user's services — newest first — optionally filtered to one or more services and a closed time window. Reports when the window predates the 30-day raw-retention limit, so an empty result is never mistaken for a quiet period.
auth requiredread-onlymcp
| Field | Type | Required | Description |
|---|---|---|---|
serviceId | string | no | Limit to one service. |
serviceIds | array | no | Limit to these services. |
since | string | no | ISO timestamp; only return checks at or after this time. |
until | string | no | ISO timestamp; only return checks strictly before this time. With `since`, selects a closed window. |
limit | integer | no | Max rows, newest first (default 100, max 2000). |
list-incidents#
List incidents — Return the signed-in user's incidents (the times Beaam decided something was genuinely wrong), newest first.
auth requiredread-onlymcp
| Field | Type | Required | Description |
|---|---|---|---|
openOnly | boolean | no | Only currently-open incidents. |
limit | integer | no | Max rows (default 50). |
list-recent-changes#
List recent changes — Return recent control-plane changes across your connected providers — deploys, config edits, scaling and pauses — newest first.
auth requiredread-onlymcp
| Field | Type | Required | Description |
|---|---|---|---|
limit | number | no | How many changes to return (1–50, default 10). |
integrationId | string | no | Only changes from this connection. Omit for the whole estate. |
list-suppressions#
List suppressions — Return what Beaam noticed but chose not to alert on (and why), newest first.
auth requiredread-onlymcp
| Field | Type | Required | Description |
|---|---|---|---|
limit | integer | no | Max rows (default 50). |
review-alert#
Review an alert — Mark a past alert as a real incident or a false alarm, so Beaam can track and tune its accuracy.
auth requireddestructivemcp
| Field | Type | Required | Description |
|---|---|---|---|
alertId | string | yes | |
wasReal | boolean | yes | True if it was a real incident. |
snooze-incident#
Snooze an incident — Stay quiet about an incident for a while ("not now"). Pass minutes to snooze, or 0 to clear it.
auth requireddestructivemcp
| Field | Type | Required | Description |
|---|---|---|---|
incidentId | string | yes | The incident to snooze. |
minutes | integer | yes | How long to stay quiet, in minutes. 0 (or less) clears the snooze. Capped at one week. |
Badges. read-only makes no changes ·destructive changes or removes something you already have ·mcp is exposed to assistants through the MCP connector ·public needs no authentication. Calling conventions and the response envelope are on the reference index.
Other categories: status (26), integrations (41), account (40).
Back to the API reference