---
title: "Cancel Job"
method: POST
path: "/api/mcp/cancel_job"
tags: ["mcp"]
---

# Cancel Job

`POST /api/mcp/cancel_job`

## Request

- Base URL: `https://writer.swapp1990.org` (the document declares no server; this is the origin it was published from)
- URL: `https://writer.swapp1990.org/api/mcp/cancel_job`
- Auth: none declared

Cancel an in-flight story job (`pending` or `in_progress`).

Flips both the persisted story status and the in-process job queue
so unstarted work short-circuits immediately. Already-running
chapter writes finish their current LLM call before stopping.
Safe to call on terminal jobs — no-op.

## Request body

- JobInput
  - `job_id` string, required: The story job ID.

## Response `200`

Successful Response

- StoryMutationResponse
  - `job_id` string, nullable
  - `status` string, nullable
  - `story_url` string, nullable
  - `chapter` integer, nullable
  - `kind` string, nullable

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/swapp1990/apis/writeforyou-mcp-api.md) · [All operations](https://skmtc.dev/swapp1990/apis/writeforyou-mcp-api/llms.txt) · [OpenAPI document](https://skmtc.dev/swapp1990/apis/writeforyou-mcp-api/revisions/ce5e2a89ab4d?raw)