MOmonta
Alerts

Create a manual alert.

Changed on

The scope (and any attached issues) must belong to the operator the alert is created under.<br/><br/>Required scope: alerts:write

post/api/v1/alerts

Request

  • Base URL
    https://partner-api.monta.com
  • URL
    https://partner-api.monta.com/api/v1/alerts
  • Auth
    HTTP bearer

Request body

operatorIdinteger nullable

Operator to create the alert under. Defaults to your own operator.

typestring required

The alert type token.

titlestring nullable

Human label for the alert.

triggerReasonstring nullable

Why the alert was raised.

issueIdsstring[] nullable

Ids of existing issues of the same operator to attach, at most 100.

Example request

{
  "type": "charge_point_offline",
  "scope": {
    "type": "charge-point",
    "id": "42"
  }
}

Response

post-alert 200 response

idstring required

Id of the alert.

operatorIdinteger

Id of the operator this alert belongs to.

typestring required

The aggregated issue-type token this alert groups.

status'open' | 'acknowledged' | 'snoozed' | 'resolved' | 'unknown' required

Current status of the alert.

titlestring nullable

Human label for the alert, if set.

triggerReasonstring nullable

Human-readable explanation for why this alert was raised, if set.

issueCountinteger

Number of issues currently attached to this alert.

eventCountinteger

Total events across every attached issue.

chargePointCountinteger

Number of distinct charge points across every attached issue.

firstEventAtstring date-time nullable

Earliest event across every attached issue, if any.

lastEventAtstring date-time nullable

Most recent event across every attached issue, if any.

isManualboolean

Whether this alert was created by hand rather than by the alerting engine.

snoozedUntilstring date-time nullable

When a snoozed alert automatically re-opens, if set.

Example response

{
  "id": "8821",
  "operatorId": 1,
  "type": "charge_point_offline",
  "scope": {
    "type": "charge-point",
    "id": "42"
  },
  "status": "open",
  "issueCount": 3,
  "eventCount": 47,
  "chargePointCount": 2,
  "eventFrequency": [
    {
      "start": "2026-06-26T00:00:00Z",
      "count": 12
    }
  ]
}

Changes