MOmonta
Charge Points

Create or update an external ticket reference for a charge point

Changed on

Idempotent on system + externalId: the first call creates the reference, later calls update it. Replaces the whole record: an omitted optional field is stored as null.</br></br>Required scope: tickets:write </br>Organization authorization: supported

put/api/v1/charge-points/{chargePointId}/tickets/{system}/{externalId}

Request

  • Base URL
    https://partner-api.monta.com
  • URL
    https://partner-api.monta.com/api/v1/charge-points/{chargePointId}/tickets/{system}/{externalId}
  • Auth
    HTTP bearer

Path parameters

systemstring required

External system the ticket lives in (lowercase letters, digits and dashes, max 32)

externalIdstring required

Id of the ticket in the external system (letters, digits and ._:-, max 255)

chargePointIdinteger required

Request body

titlestring required

Title of the ticket

status'open' | 'acknowledged' | 'in_progress' | 'on_hold' | 'resolved' | 'closed' | 'cancelled' required

Status of the ticket, normalised across external systems

nativeStatusstring nullable

Status as reported by the external system

urlstring nullable

HTTPS link to the ticket in the external system

alertIdstring nullable

Id of the alert that triggered the ticket

alertOpenedAtstring date-time nullable

When the triggering alert was opened

ticketCreatedAtstring date-time nullable

When the ticket was created in the external system

commentCountinteger nullable

Number of comments on the ticket in the external system

lastCommentAtstring date-time nullable

When the last comment was added in the external system

returnedToServiceAtstring date-time nullable

When the external system reported the charge point back in service

Example request

{
  "title": "Charge point offline",
  "status": "in_progress",
  "nativeStatus": "IN_PROGRESS",
  "url": "https://app.getmaintainx.com/workorders/124383489",
  "alertId": "8821",
  "alertOpenedAt": "2026-10-01T08:00:00Z",
  "ticketCreatedAt": "2026-10-01T08:05:00Z",
  "commentCount": 3,
  "lastCommentAt": "2026-10-01T09:30:00Z",
  "returnedToServiceAt": "2026-10-01T12:00:00Z"
}

Response

Ticket reference created or updated

idinteger

Id of this ticket reference

chargePointIdinteger

Id of the charge point this ticket belongs to

systemstring required

External system the ticket lives in

externalIdstring required

Id of the ticket in the external system

titlestring required

Title of the ticket

status'open' | 'acknowledged' | 'in_progress' | 'on_hold' | 'resolved' | 'closed' | 'cancelled' required

Status of the ticket, normalised across external systems

nativeStatusstring nullable

Status as reported by the external system

urlstring nullable

Link to the ticket in the external system

alertIdstring nullable

Id of the alert that triggered the ticket

alertOpenedAtstring date-time nullable

When the triggering alert was opened

ticketCreatedAtstring date-time nullable

When the ticket was created in the external system

commentCountinteger nullable

Number of comments on the ticket in the external system

lastCommentAtstring date-time nullable

When the last comment was added in the external system

returnedToServiceAtstring date-time nullable

When the external system reported the charge point back in service

createdAtstring date-time required

Creation date of this ticket reference

updatedAtstring date-time required

Date this ticket reference was last updated

Example response

{
  "id": 1,
  "chargePointId": 42,
  "system": "maintainx",
  "externalId": "124383489",
  "title": "Charge point offline",
  "status": "in_progress",
  "nativeStatus": "IN_PROGRESS",
  "url": "https://app.getmaintainx.com/workorders/124383489",
  "alertId": "8821",
  "alertOpenedAt": "2026-10-01T08:00:00Z",
  "ticketCreatedAt": "2026-10-01T08:05:00Z",
  "commentCount": 3,
  "lastCommentAt": "2026-10-01T09:30:00Z",
  "returnedToServiceAt": "2026-10-01T12:00:00Z",
  "createdAt": "2026-10-01T08:05:10Z",
  "updatedAt": "2026-10-02T10:00:00Z"
}

Changes