Cancel a post

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

DELETE /api/v1/posts/{id} is part of the Posting API. Every call needs an access key: see 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

NameInTypeRequiredNotes
idpathstringyes

Example request

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

Responses

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

A successful answer:

{
  "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

Something wrong or missing? Write to support@wavegrain.com.