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 being published right now, which fails with a 409 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.
The social calendar endpoints share two rate limits: 20 requests per minute across creating, editing, deleting and approving posts, and 40 requests per minute across the rest. This endpoint counts against the 20.
<Note>This endpoint accepts a personal API key. Workspace API keys are not authorized for it and are rejected with a 403.</Note>
Path parameters
ID of the post, as returned by List scheduled posts.
ID of the post, as returned by List scheduled posts.
ID of the app whose social calendar you want.
ID of the app whose social calendar you want.
Response
The post is deleted.
Example response
{
"status": "ok"
}Changes
No recorded changes to this endpoint across all 1 revision of this API.