---
title: "Create an issue"
method: POST
path: "/api/issues"
tags: ["issues"]
---

# Create an issue

`POST /api/issues`

## Request

- Base URL: `https://cronitor.io`
- URL: `https://cronitor.io/api/issues`
- Auth: HTTP basic

## Query parameters

- `withAlertDetails` boolean
- `withComponentDetails` boolean
- `withEnvironmentDetails` boolean
- `withMonitorDetails` boolean
- `withStatusPageDetails` boolean

## Headers

- `Cronitor-Version` '2025-11-28' | '2020-10-01'

## Request body

- IssueRequest
  - `name` string, required
  - `severity` union
    - 'missing_data' | 'operational' | 'maintenance' | 'degraded_performance' | 'minor_outage' | 'outage': * `missing_data` - missing_data * `operational` - operational * `maintenance` - maintenance * `degraded_performance` - degraded_performance * `minor_outage` - minor_outage * `outage` - outage
    - unknown
  - `state` 'unresolved' | 'investigating' | 'identified' | 'monitoring' | 'resolved' | 'update': * `unresolved` - unresolved * `investigating` - investigating * `identified` - identified * `monitoring` - monitoring * `resolved` - resolved * `update` - update
  - `updates` IncidentUpdateRequest[]
    - `key` string
    - `timestamp` string, date-time
    - `message` string
    - `state` 'unresolved' | 'investigating' | 'identified' | 'monitoring' | 'resolved' | 'update': * `unresolved` - unresolved * `investigating` - investigating * `identified` - identified * `monitoring` - monitoring * `resolved` - resolved * `update` - update
    - `created_by` string, email, nullable
  - `started` string, date-time
  - `statuspages` string[]: Status page keys.
  - `affected_components` string[]: Status page component keys.
  - `environment` string: Environment key.
  - `assigned_to` string, email, nullable: Email address of the assigned team member.

## Response `201`

- Issue
  - `key` string, required
  - `name` string, required
  - `severity` union
    - 'missing_data' | 'operational' | 'maintenance' | 'degraded_performance' | 'minor_outage' | 'outage': * `missing_data` - missing_data * `operational` - operational * `maintenance` - maintenance * `degraded_performance` - degraded_performance * `minor_outage` - minor_outage * `outage` - outage
    - unknown
  - `state` 'unresolved' | 'investigating' | 'identified' | 'monitoring' | 'resolved' | 'update': * `unresolved` - unresolved * `investigating` - investigating * `identified` - identified * `monitoring` - monitoring * `resolved` - resolved * `update` - update
  - `updates` IncidentUpdate[]
    - `key` string
    - `timestamp` string, date-time
    - `message` string
    - `state` 'unresolved' | 'investigating' | 'identified' | 'monitoring' | 'resolved' | 'update': * `unresolved` - unresolved * `investigating` - investigating * `identified` - identified * `monitoring` - monitoring * `resolved` - resolved * `update` - update
    - `created` string, date-time, required
    - `updated` string, date-time, required
    - `created_by` string, email, nullable
  - `started` string, date-time
  - `ended` string, date-time, nullable, required
  - `duration` integer, required: Seconds of downtime.
  - `statuspages` string[]: Status page keys.
  - `affected_components` string[]: Status page component keys.
  - `monitors` object[], nullable, required: Null unless withMonitorDetails=true, which includes monitor details.
    - `key` string
    - `name` string
  - `alerts` object[], nullable, required: Present with withAlertDetails=true.
  - `environment` string: Environment key.
  - `created_by` unknown, required
  - `assigned_to` string, email, nullable: Email address of the assigned team member.
  - `created` string, date-time, required
  - `updated` string, date-time, required

---

[API](https://skmtc.dev/cronitor/apis/cronitor-api.md) - [All operations](https://skmtc.dev/cronitor/apis/cronitor-api/llms.txt) - [OpenAPI document](https://skmtc.dev/cronitor/apis/cronitor-api/revisions/62fb38ef4462?raw)