---
title: "Create Incident"
method: POST
path: "/api/v1/incidents"
tags: ["Incidents"]
---

# Create Incident

`POST /api/v1/incidents`

## Request

- Base URL: `https://public-api.linearb.io`
- URL: `https://public-api.linearb.io/api/v1/incidents`
- Auth: API key in header `x-api-key`
- TypeScript: <https://skmtc.dev/linearb/apis/linearb-api/docs/api/v1/incidents/post.ts> (a function with typed inputs; its response is checked against the schema)

**Create Incident**

## Request body

- CreateIncidentRequestModel: This model ovverides default functionality and remove nullable field from dict object :param BaseModel: the BaseModel
  - `provider_id` string, required: The unique identifier in the PM provider
  - `http_url` string, required: Trace back URL to the PM provider URL/key should open the incident in the PM provider
  - `title` string, required: The title of the incident
  - `issued_at` string, required: The incident was open at this specific time, can be ISO8601 or EPOCH timestmap
  - `started_at` string: The incident was started at this specific time, can be ISO8601 or EPOCH timestmap
  - `ended_at` string: The incident was resolved at this specific time, can be ISO8601 or EPOCH timestmap
  - `git_ref` string: The git reference of the release, i.e. commit short or long sha or tag name
  - `teams` string[]: The list of LinearB teams names related to this incident
  - `services` string[]: The list of LinearB services monitoring this incident
  - `repository_urls` string[]: The list of repos urls related to this incident

## Response `200`

Successful Response

## Other responses

- `201`: Successful Response
- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found
- `405`: Method Not Allowed
- `409`: Conflict
- `422`: Validation Error
- `500`: Internal Server Error
- `504`: Gateway Timeout

---

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