---
title: "Revert To Story"
method: POST
path: "/sessions/{session_id}/revert-to-story"
tags: ["sessions"]
---

# Revert To Story

`POST /sessions/{session_id}/revert-to-story`

## Request

- Base URL: `https://api.nicheangle.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.nicheangle.com/sessions/{session_id}/revert-to-story`
- Auth: none declared

Go back to CP1 (story selection) from anywhere in or past the pipeline.
Cancels the current orchestrator task, clears all state from CP1 onward,
and re-spawns. The orchestrator's idempotent stages will skip work that's
already done (research, clustering, ranking) and land cleanly at CP1.

Allowed at any point after stories have been ranked — including during
in-flight stages like generating_angles, applying_voice, generating_content,
or rendering. The orchestrator handles the cancellation cleanly via
task_registry.cancel.

## Path parameters

- `session_id` string, uuid, required

## Headers

- `authorization` string, nullable

## Response `200`

Successful Response

- StoryWorkspaceResponse
  - `stories` object[], required
  - `visible_limit` integer
  - `total_candidates` integer, required
  - `has_more_candidates` boolean, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/nicheangle/apis/signal-api.md) · [All operations](https://skmtc.dev/nicheangle/apis/signal-api/llms.txt) · [OpenAPI document](https://skmtc.dev/nicheangle/apis/signal-api/revisions/ed8b47ff5891?raw)