---
title: "Deleting an existing Story"
method: DELETE
path: "/stories/{id}"
tags: ["Stories"]
---

# Deleting an existing Story

`DELETE /stories/{id}`

## Request

- Base URL: `https://api.mavenlink.com/api/v1`
- URL: `https://api.mavenlink.com/api/v1/stories/{id}`
- Auth: none declared

Soft deletes a task (by setting a value for `deleted_at`). You can view soft deleted tasks by fetching a
list of tasks with the `only_deleted` filter set to `true`.

Note: Tasks are only permanently deleted when the project is deleted.


The response will contain no content and an HTTP 204 status code if the request was
successful, or a [standard Kantata OX error message](#section/Errors) explaining why the object could not be deleted.

## Path parameters

- `id` integer, required

## Response `204`

Story has been deleted.

## Other responses

- `400`: Bad Request
- `401`: Unauthorized request
- `403`: Forbidden request
- `404`: Page Not Found
- `422`: Unprocessable Entity
- `503`: Service is unavailable

---

[API](https://skmtc.dev/kantata/apis/kantata-ox-api-documentation.md) - [All operations](https://skmtc.dev/kantata/apis/kantata-ox-api-documentation/llms.txt) - [OpenAPI document](https://skmtc.dev/kantata/apis/kantata-ox-api-documentation/revisions/9d4ebed2fa98?raw)