---
title: "Create an Incident Retrospective"
method: PATCH
path: "/retrospectives/{id}"
tags: ["Retrospectives"]
---

# Create an Incident Retrospective

`PATCH /retrospectives/{id}`

## Path parameters

- `id` string, required

## Request body

- UpdateRetrospectiveRequestBody
  - `$schema` string, uri — A URL to the JSON Schema for this object.
  - `attributes` UpdateRetrospectiveAttributes, required

## Response `200`

OK

- UpdateRetrospectiveResponseBody
  - `$schema` string, uri — A URL to the JSON Schema for this object.
  - `data` Retrospective, required
    - `attributes` RetrospectiveAttributes, required
      - `documentId` string, required
      - `reportSections` RetrospectiveReportSection[], required
        - `description` string, required
        - `field` string, required
        - `kind` 'field', required
        - `title` string, required
      - `state` 'draft' | 'in_review' | 'meeting_scheduled' | 'completed', required
      - `systemAnalysisId` string, required
      - `type` 'simple' | 'full', required
    - `id` string, required

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `422` — Unprocessable Entity
- `500` — Internal Server Error

---

[API](https://skmtc.net/rezible/apis/rezible-api.md) · [All operations](https://skmtc.net/rezible/apis/rezible-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/rezible/rezible-api/versions/d226beeef0bf/schema)