Skip to content
Dashboard

Cancel a planned Instagram post

DELETE
/instagram/posts/{id}
curl --request DELETE \
--url https://app.whatsetter.com/api/v1/instagram/posts/example \
--header 'Authorization: Bearer <token>'

Cancels a post still waiting for its time, or removes a failed one. Its uploaded files are deleted (never a file another planned post still uses). A post already on its way or published answers 409. Requires scope instagram:write.

id
required
string

A planned post (from listInstagramPosts or createInstagramPost).

Cancelled

Media typeapplication/json
object
data
object
id
string
status
string
Allowed values: cancelled
Example
{
"data": {
"status": "cancelled"
}
}

Missing, unknown or revoked API key

Media typeapplication/json
object
error
object
code
string
message
string
Examplegenerated
{
"error": {
"code": "example",
"message": "example"
}
}

The key lacks the required scope (insufficient_scope), the plan does not have this part of the API (not_in_plan), or Instagram is not enabled on the workspace (instagram_not_enabled, Instagram routes)

Media typeapplication/json
object
error
object
code
string
message
string
Examplegenerated
{
"error": {
"code": "example",
"message": "example"
}
}

Resource not found in this workspace

Media typeapplication/json
object
error
object
code
string
message
string
Examplegenerated
{
"error": {
"code": "example",
"message": "example"
}
}

The post is already on its way to Instagram (post_already_started) or already published (post_already_published).