---
title: "Delete a draft or a scheduled post"
method: DELETE
path: "/posts/{id}"
---

# Delete a draft or a scheduled post

`DELETE /posts/{id}`

## Request

- Base URL: `https://govir.app/api/v1`
- URL: `https://govir.app/api/v1/posts/{id}`
- Auth: HTTP bearer

Scope: `write`.

## Path parameters

- `id` string, uuid, required

## Response `200`

OK

- object
  - `id` string, uuid
  - `deleted` true

## Other responses

- `401`: No key, a wrong key, or a revoked one
- `403`: The key lacks the scope, or publishing right away isn't allowed
- `404`: Not found in your workspace
- `409`: Not possible now, or warnings to confirm (needs_confirmation)
- `429`: Too many requests; see Retry-After

---

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