Alerts

Retrieve a list of alerts.

GET

https://partner-api.monta.com

/api/v1/alerts

Required scope: alerts:read

Retrieve a list of alerts. › query Parameters

operatorId

integer | null · int64

Restrict to a sub-operator. Required when your consumer has access to more than one operator and none is implied by your credentials.

Example: 10

status

string | null · enum

Filter by alert status.

Enum values:

open

acknowledged

snoozed

resolved

Example: open

lastEventFrom

string | null · date-time

Only include alerts with an event at or after this time.

Example: 2026-06-01T00:00:00Z

Retrieve a list of alerts. › Responses

get-alerts 200 response

OffsetBasedResponse

Alert[] · required

MontaPage.Meta · required

GET/api/v1/alerts

curl https://partner-api.monta.com/api/v1/alerts \
  --header 'Authorization: Bearer <token>'

Example Responses

{
  "data": [
    {
      "id": "8821",
      "operatorId": 1,
      "type": "charge_point_offline",
      "scope": {
        "type": "charge-point",
        "id": "42"
      },
      "status": "open",
      "title": "title",
      "triggerReason": "triggerReason",
      "issueCount": 3,
      "eventCount": 47,
      "chargePointCount": 2,
      "firstEventAt": "2024-08-25T15:00:00Z",
      "lastEventAt": "2024-08-25T15:00:00Z",
      "isManual": false,
      "snoozedUntil": "2024-08-25T15:00:00Z",
      "eventFrequency": [
        {
          "start": "2026-06-26T00:00:00Z",
          "count": 12
        }
      ]
    }
  ],
  "meta": {
    "itemCount": 0,
    "currentPage": 0,
    "perPage": 0,
    "totalPageCount": 0,
    "totalItemCount": 0
  }
}

json

application/json

Create a manual alert.

POST

https://partner-api.monta.com

/api/v1/alerts

The scope (and any attached issues) must belong to the operator the alert is created under.

Required scope: alerts:write

Create a manual alert. › Request Body

A manual alert, optionally attached to existing issues.

CreateAlert

type

string · minLength: 1 · maxLength: 255 · required

The alert type token.

Example: charge_point_offline

AlertScopeInput · required

What a new alert or issue is about.

operatorId

integer | null · int64

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

title

string | null · maxLength: 512

Human label for the alert.

triggerReason

string | null · maxLength: 2000

Why the alert was raised.

issueIds

array | null · maxItems: 100

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

Create a manual alert. › Responses

post-alert 200 response

An operational alert aggregating one or more issues for your operator.

Alert

id

string · required

Id of the alert.

Example: 8821

type

string · required

The aggregated issue-type token this alert groups.

Example: charge_point_offline

AlertScope · required

What an alert or issue is about.

status

string · enum · required

Current status of the alert.

Enum values:

open

acknowledged

snoozed

resolved

unknown

Example: open

operatorId

integer · int64

Id of the operator this alert belongs to.

Example: 1

title

string | null

Human label for the alert, if set.

triggerReason

string | null

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

issueCount

integer · int64

Number of issues currently attached to this alert.

Example: 3

eventCount

integer · int64

Total events across every attached issue.

Example: 47

chargePointCount

integer · int64

Number of distinct charge points across every attached issue.

Example: 2

firstEventAt

string | null · date-time

Earliest event across every attached issue, if any.

lastEventAt

string | null · date-time

Most recent event across every attached issue, if any.

isManual

boolean

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

Example: false

snoozedUntil

string | null · date-time

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

array | null

Day-bucketed event counts across every attached issue.

POST/api/v1/alerts

curl https://partner-api.monta.com/api/v1/alerts \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <token>' \
  --data '{
  "operatorId": 0,
  "type": "charge_point_offline",
  "scope": {
    "type": "charge-point",
    "id": "42"
  },
  "title": "title",
  "triggerReason": "triggerReason",
  "issueIds": [
    "string"
  ]
}'

Example Request Body

{
  "operatorId": 0,
  "type": "charge_point_offline",
  "scope": {
    "type": "charge-point",
    "id": "42"
  },
  "title": "title",
  "triggerReason": "triggerReason",
  "issueIds": [
    "string"
  ]
}

json

Example Responses

{
  "id": "8821",
  "operatorId": 1,
  "type": "charge_point_offline",
  "scope": {
    "type": "charge-point",
    "id": "42"
  },
  "status": "open",
  "title": "title",
  "triggerReason": "triggerReason",
  "issueCount": 3,
  "eventCount": 47,
  "chargePointCount": 2,
  "firstEventAt": "2024-08-25T15:00:00Z",
  "lastEventAt": "2024-08-25T15:00:00Z",
  "isManual": false,
  "snoozedUntil": "2024-08-25T15:00:00Z",
  "eventFrequency": [
    {
      "start": "2026-06-26T00:00:00Z",
      "count": 12
    }
  ]
}

json

application/json

Retrieve a single alert.

GET

https://partner-api.monta.com

/api/v1/alerts/{alertId}

Required scope: alerts:read

Retrieve a single alert. › path Parameters

alertId

string · required

Retrieve a single alert. › query Parameters

operatorId

integer | null · int64

Retrieve a single alert. › Responses

get-alert 200 response

An alert with its member issues, delivery notifications and event-source breakdown.

AlertDetail

id

string · required

Id of the alert.

Example: 8821

operatorId

integer · int64 · required

type

string · required

AlertScope · required

What an alert or issue is about.

status

string · required

issueCount

integer · int64 · required

eventCount

integer · int64 · required

chargePointCount

integer · int64 · required

isManual

boolean · required

Issue[] · required

Issues attached to this alert.

AlertNotification[] · required

Notifications (Monta workflow runs) this alert has produced.

object · required

Event-source breakdown across every attached issue.

title

string | null

triggerReason

string | null

firstEventAt

string | null · date-time

lastEventAt

string | null · date-time

snoozedUntil

string | null · date-time

array | null

GET/api/v1/alerts/{alertId}

curl https://partner-api.monta.com/api/v1/alerts/:alertId \
  --header 'Authorization: Bearer <token>'

Example Responses

{
  "id": "8821",
  "operatorId": 0,
  "type": "type",
  "scope": {
    "type": "charge-point",
    "id": "42"
  },
  "status": "status",
  "title": "title",
  "triggerReason": "triggerReason",
  "issueCount": 0,
  "eventCount": 0,
  "chargePointCount": 0,
  "firstEventAt": "2024-08-25T15:00:00Z",
  "lastEventAt": "2024-08-25T15:00:00Z",
  "isManual": true,
  "snoozedUntil": "2024-08-25T15:00:00Z",
  "eventFrequency": [
    {
      "start": "2026-06-26T00:00:00Z",
      "count": 12
    }
  ],
  "issues": [
    {
      "id": "5510",
      "operatorId": 1,
      "type": "charge_point_offline",
      "scope": {
        "type": "charge-point",
        "id": "42"
      },
      "teamId": "teamId",
      "siteId": "siteId",
      "status": "open",
      "eventCount": 14,
      "firstEventAt": "2024-08-25T15:00:00Z",
      "lastEventAt": "2024-08-25T15:00:00Z",
      "resolvedAt": "2024-08-25T15:00:00Z"
    }
  ],
  "notifications": [
    {
      "id": "551",
      "workflowName": "Notify site owner",
      "triggeredAt": "2026-06-26T13:40:00Z",
      "outcome": "sent",
      "channels": [
        "email",
        "sms"
      ]
    }
  ],
  "sources": {
    "breakdowns": [
      {
        "dimension": "site",
        "title": "Site",
        "entries": [
          {
            "label": "Copenhagen HQ",
            "count": 9,
            "assetType": "assetType",
            "assetId": "assetId"
          }
        ]
      }
    ]
  }
}

json

application/json

Retrieve the comments on an alert.

GET

https://partner-api.monta.com

/api/v1/alerts/{alertId}/comments

Required scope: alerts:read

Retrieve the comments on an alert. › path Parameters

alertId

string · required

Retrieve the comments on an alert. › query Parameters

operatorId

integer | null · int64

Retrieve the comments on an alert. › Responses

get-alert-comments 200 response

OffsetBasedResponse_1

AlertComment[] · required

MontaPage.Meta · required

Comment on an alert.

POST

https://partner-api.monta.com

/api/v1/alerts/{alertId}/comments

Required scope: alerts:write

Comment on an alert. › path Parameters

alertId

string · required

Comment on an alert. › query Parameters

operatorId

integer | null · int64

Comment on an alert. › Request Body

A comment on an alert or an issue.

CreateAlertComment

body

string · minLength: 1 · maxLength: 5000 · required

Comment body, at most 5000 characters.

Example: Escalated to the site owner.

Comment on an alert. › Responses

post-alert-comment 200 response

A comment left on an alert or an issue.

AlertComment

id

string · required

Id of the comment.

Example: 331

authorName

string · required

Display name of the author.

Example: Jane Doe

body

string · required

Comment body.

Example: Escalated to the site owner.

createdAt

string · date-time · required

When the comment was posted.

Example: 2026-06-26T13:40:00Z

authorId

string | null

Author's user id, if known.

Resolve an alert.

POST

https://partner-api.monta.com

/api/v1/alerts/{alertId}/resolve

Required scope: alerts:write

Resolve an alert. › path Parameters

alertId

string · required

Resolve an alert. › query Parameters

operatorId

integer | null · int64

Resolve an alert. › Responses

resolve-alert 200 response

An operational alert aggregating one or more issues for your operator.

Alert

id

string · required

Id of the alert.

Example: 8821

type

string · required

The aggregated issue-type token this alert groups.

Example: charge_point_offline

AlertScope · required

What an alert or issue is about.

status

string · enum · required

Current status of the alert.

Enum values:

open

acknowledged

snoozed

resolved

unknown

Example: open

operatorId

integer · int64

Id of the operator this alert belongs to.

Example: 1

title

string | null

Human label for the alert, if set.

triggerReason

string | null

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

issueCount

integer · int64

Number of issues currently attached to this alert.

Example: 3

eventCount

integer · int64

Total events across every attached issue.

Example: 47

chargePointCount

integer · int64

Number of distinct charge points across every attached issue.

Example: 2

firstEventAt

string | null · date-time

Earliest event across every attached issue, if any.

lastEventAt

string | null · date-time

Most recent event across every attached issue, if any.

isManual

boolean

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

Example: false

snoozedUntil

string | null · date-time

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

array | null

Day-bucketed event counts across every attached issue.

Snooze an alert.

POST

https://partner-api.monta.com

/api/v1/alerts/{alertId}/snooze

Required scope: alerts:write

Snooze an alert. › path Parameters

alertId

string · required

Snooze an alert. › query Parameters

operatorId

integer | null · int64

Snooze an alert. › Request Body

Snoozes an alert.

SnoozeAlert

snoozedUntil

string | null · date-time

When the alert wakes up again. Omit to snooze until it is changed manually.

Snooze an alert. › Responses

snooze-alert 200 response

An operational alert aggregating one or more issues for your operator.

Alert

id

string · required

Id of the alert.

Example: 8821

type

string · required

The aggregated issue-type token this alert groups.

Example: charge_point_offline

AlertScope · required

What an alert or issue is about.

status

string · enum · required

Current status of the alert.

Enum values:

open

acknowledged

snoozed

resolved

unknown

Example: open

operatorId

integer · int64

Id of the operator this alert belongs to.

Example: 1

title

string | null

Human label for the alert, if set.

triggerReason

string | null

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

issueCount

integer · int64

Number of issues currently attached to this alert.

Example: 3

eventCount

integer · int64

Total events across every attached issue.

Example: 47

chargePointCount

integer · int64

Number of distinct charge points across every attached issue.

Example: 2

firstEventAt

string | null · date-time

Earliest event across every attached issue, if any.

lastEventAt

string | null · date-time

Most recent event across every attached issue, if any.

isManual

boolean

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

Example: false

snoozedUntil

string | null · date-time

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

array | null

Day-bucketed event counts across every attached issue.

POST/api/v1/alerts/{alertId}/snooze

curl https://partner-api.monta.com/api/v1/alerts/:alertId/snooze \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <token>' \
  --data '{
  "snoozedUntil": "2024-08-25T15:00:00Z"
}'

Example Request Body

{
  "snoozedUntil": "2024-08-25T15:00:00Z"
}

json

Example Responses

{
  "id": "8821",
  "operatorId": 1,
  "type": "charge_point_offline",
  "scope": {
    "type": "charge-point",
    "id": "42"
  },
  "status": "open",
  "title": "title",
  "triggerReason": "triggerReason",
  "issueCount": 3,
  "eventCount": 47,
  "chargePointCount": 2,
  "firstEventAt": "2024-08-25T15:00:00Z",
  "lastEventAt": "2024-08-25T15:00:00Z",
  "isManual": false,
  "snoozedUntil": "2024-08-25T15:00:00Z",
  "eventFrequency": [
    {
      "start": "2026-06-26T00:00:00Z",
      "count": 12
    }
  ]
}

json

application/json

AFIR Charge Points Audit Log