---
title: "Cancel a post"
method: DELETE
path: "/posts"
tags: ["Posts"]
---

# Cancel a post

`DELETE /posts`

## Request

- Base URL: `https://api.misar.io/post`
- URL: `https://api.misar.io/post/posts`
- Auth: API key in header `Authorization`

Cancels a post that is still `pending` or `queued`. Posts in any other status cannot be cancelled this way. Rate limit: 20 requests/minute.

## Request body

- CancelPostRequest
  - `postId` string, uuid, required

## Response `200`

Cancelled.

- OkResponse
  - `ok` true, required

## Other responses

- `400`: Request body failed schema validation. `error` is a Zod `flatten()`-shaped object (`fieldErrors` / `formErrors`), not a plain string.
- `401`: Missing, malformed, revoked, or invalid API key/session.
- `402`: Plan limit: no active plan (any write; `reason: "no_active_plan"`), a monthly allowance is spent, or the feature is not on the caller's plan. Detect by `code: "plan_limit_exceeded"`.
- `403`: The API key lacks the scope this operation requires (`code: "insufficient_scope"`, `required_scope`).
- `429`: Per-user, per-route rate limit exceeded for this endpoint.

---

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