# Cancel a post

> Cancel a post with the Wavegrain Posting API: DELETE /api/v1/posts/{id}. Parameters, responses and an example request.

> Index of these docs: https://wavegrain.com/developers/llms.txt

`DELETE /api/v1/posts/{id}` is part of the [Posting API](/developers/posting-api). Every call needs an access key: see [Authentication](/developers/authentication).

Needs the `post` permission. A post made through the API that waits for the owner's confirm is never sent. For a confirmed one, every delivery that has not started sending is cancelled; the answer names the ones that had already started. A slideshow's posts are cancelled in Wavegrain.

## Parameters

| Name | In | Type | Required | Notes |
| --- | --- | --- | --- | --- |
| `id` | path | string | yes |  |

## Example request

```bash
curl -X DELETE https://wavegrain.com/api/v1/posts/ID \
  -H "Authorization: Bearer $WAVEGRAIN_KEY"
```

## Responses

| Status | Meaning |
| --- | --- |
| 200 | What was cancelled. |
| 401 | No access key, or an unknown, revoked or expired one |
| 403 | The key lacks the permission, or the account has no active plan |
| 404 | No such post made through the API, or not yours. |
| 429 | Too many requests for the key or the account |
| 500 | Something went wrong on Wavegrain's side; try again, and send the request id if it keeps failing. |

A successful answer:

```json
{
  "post": {
    "id": "post_V1StGXR8_Z5jdHi6B",
    "source": "api",
    "slideshowId": null,
    "title": null,
    "status": "cancelled",
    "confirmUrl": null,
    "scheduledFor": "2026-11-07T09:00:00.000Z",
    "targets": [
      {
        "accountId": "acc_4Ft7Wz",
        "accountName": "Koi Kitchen",
        "network": "instagram",
        "state": "cancelled",
        "deliveryId": null,
        "reason": null
      }
    ],
    "deliveries": []
  },
  "cancelled": [],
  "alreadyStarted": []
}
```

## More in the Posting API

- [List brands, groups and connected accounts](/developers/api/list-accounts): `GET /api/v1/accounts`
- [List posts](/developers/api/list-posts): `GET /api/v1/posts`
- [Create a post](/developers/api/create-post): `POST /api/v1/posts`
- [Get a post](/developers/api/get-post): `GET /api/v1/posts/{id}`
- [Start an image or video upload](/developers/api/create-upload): `POST /api/v1/media`
- [Get an upload](/developers/api/get-upload): `GET /api/v1/media/{id}`
- [Delete a video](/developers/api/delete-video): `DELETE /api/v1/media/{id}`
- [Finish and check a video upload](/developers/api/complete-video-upload): `POST /api/v1/media/{id}/complete`
- [Write captions](/developers/api/write-captions): `POST /api/v1/captions`
- [All endpoints](/developers/api)
