---
title: "Create a reconciliation story"
method: POST
path: "/reconciliation_stories"
---

# Create a reconciliation story

`POST /reconciliation_stories`

Create a story and attach a chain of reconciliations. The first link must use role `origin` and have no shared_data_stream_id; subsequent links must use role `continuation` and specify the shared data stream linking them to the previous reconciliation.

## Request body

- object
  - `name` string, required
  - `links` object[]
    - `reconciliation_id` string, required
    - `position` integer, required — 1-indexed position in the chain
    - `role` 'origin' | 'continuation'
    - `shared_data_stream_id` string, nullable — Required for continuation links

## Response `201`

Story created

- ReconciliationStory — A reconciliation story groups related reconciliations into an ordered chain so end-to-end flow can be tracked. Each link points to a reconciliation; non-origin links must specify the data stream that connects them to the previous reconciliation in the chain.
  - `id` integer
  - `name` string, required — Human readable name for the story
  - `created_at` string, date-time
  - `links` ReconciliationStoryLink[] — Ordered list of reconciliations participating in the story
    - `id` integer
    - `position` integer, required — 1-indexed position in the chain. Must be unique within a story.
    - `role` 'origin' | 'continuation', required — The first link is the 'origin'. All subsequent links are 'continuation' and must set shared_data_stream_id.
    - `reconciliation_id` integer, required — The reconciliation this link points to
    - `reconciliation_name` string
    - `shared_data_stream_id` integer, nullable — The data stream that connects this link to the previous link in the chain. Required for continuation links, null for origin.
    - `shared_data_stream_name` string, nullable
    - `side_a_streams` object[]
      - `id` integer
      - `name` string
    - `side_b_streams` object[]
      - `id` integer
      - `name` string

## Other responses

- `422` — Validation error

---

[API](https://skmtc.net/endclose/apis/end-close-api.md) · [All operations](https://skmtc.net/endclose/apis/end-close-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/endclose/end-close-api/revisions/613ceff68dc7/schema)