Sign in

Delete scheduled post

<Info>This API is in beta. Endpoints, fields, and behavior may still change, so avoid depending on it in production.</Info>

Removes a post from the app's social calendar.

This is how you cancel a post you already scheduled. A deleted post never publishes, even when a publisher run is already waiting on its scheduled time. The one exception is a post whose status is publishing, which can't be deleted because the request to the platform may already be in flight.

Deleting a post that's already deleted succeeds, so a repeated call is safe. The post stops appearing in List scheduled posts and reads as not found afterwards.

delete/api/apps/{app_id}/social-calendar/posts/{post_id}

Path parameters

post_idstring required

ID of the post, as returned by List scheduled posts.

ID of the post, as returned by List scheduled posts.

app_idstring required

ID of the app whose social calendar you want.

ID of the app whose social calendar you want.

Response

The post is deleted.

statusstring

Always ok. The post is deleted, or was already.

Example response

{
  "status": "ok"
}

Changes

Changed in 1 of the 18 revisions of this API.1

Of the 18 revisions, 1 has no diff computed.