---
title: "Report an issue."
method: POST
path: "/api/v1/issues"
tags: ["Issues"]
---

# Report an issue.

`POST /api/v1/issues`

## Request

- Base URL: `https://partner-api.monta.com`
- URL: `https://partner-api.monta.com/api/v1/issues`
- Auth: HTTP bearer

The scope, team and site must belong to the operator the issue is created under.<br/><br/>Required scope: `alerts:write`

## Request body

- CreateIssue: A manually reported issue.
  - `operatorId` integer, nullable: Operator to create the issue under. Defaults to your own operator.
  - `type` string, required: The issue type token.
  - `scope` AlertScopeInput, required: What a new alert or issue is about.
    - `type` 'operator' | 'site' | 'charge-point', required: The kind of entity.
    - `id` string, required: Id of the entity. For `operator` it must be the operator the alert or issue is created under.
  - `teamId` integer, nullable: Team the issue belongs to, if any. Must belong to the same operator.
  - `siteId` integer, nullable: Site the issue belongs to, if any. Must belong to the same operator.

## Response `200`

post-issue 200 response

- Issue: A single operational issue for your operator.
  - `id` string, required: Id of the issue.
  - `operatorId` integer: Id of the operator this issue belongs to.
  - `type` string, required: The issue-type token.
  - `scope` AlertScope, required: What an alert or issue is about.
    - `type` 'operator' | 'site' | 'charge-point' | 'unknown', required: The kind of entity this alert or issue is scoped to.
    - `id` string, required: Id of the scoped entity.
  - `teamId` string, nullable: Id of the team this issue is scoped to, when service-alerts exposes it. Null today.
  - `siteId` string, nullable: Id of the site this issue is scoped to, when service-alerts exposes it. Null today.
  - `status` 'open' | 'resolved' | 'unknown', required: Current status of the issue.
  - `eventCount` integer: Number of events attached to this issue.
  - `firstEventAt` string, date-time, nullable: Earliest event on this issue, if any.
  - `lastEventAt` string, date-time, nullable: Most recent event on this issue, if any.
  - `resolvedAt` string, date-time, nullable: When this issue was resolved, if it has been.

## Other responses

- `400`: The request is invalid
- `401`: Consumer with provided credentials was not found
- `403`: Operator doesn't have access to resource
- `404`: Entity with the provided id was not found

## Changes

- **2026-11-03** `0ca400461c52`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/monta/apis/monta-partner-api/changes/api/v1/issues/post.md)

---

[API](https://skmtc.dev/monta/apis/monta-partner-api.md) - [All operations](https://skmtc.dev/monta/apis/monta-partner-api/llms.txt) - [OpenAPI document](https://skmtc.dev/monta/apis/monta-partner-api/revisions/0ca400461c52?raw)