---
title: "Delete a story"
method: DELETE
path: "/v1/stories/{storyId}"
tags: ["Stories"]
---

# Delete a story

`DELETE /v1/stories/{storyId}`

## Request

- Base URL: `https://www.postquick.ai/api`
- URL: `https://www.postquick.ai/api/v1/stories/{storyId}`
- Auth: HTTP bearer

Delete a Story. The underlying media is not deleted — managed externally by the caller.

## Path parameters

- `storyId` string, required

## Response `200`

Deletes the owned database record and its future schedule only. Processing, pending video generation, unknown states, or concurrently changed records return 409; missing/unowned records return 404. Hosted and external files are retained, including shared media; storage usage is not reclaimed. Does not delete posts already sent to social platforms. Save platform IDs before deletion if needed.

- object
  - `success` true, required
  - `data` object, required
    - `deleted` true, required
    - `mediaRetained` true, required
    - `platformPostsDeleted` false, required

## Other responses

- `404`: Record not found or not owned.
- `409`: Processing, unknown state, or concurrent change; refresh before retrying.

---

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