# Cancel a planned Instagram post

`DELETE https://app.whatsetter.com/api/v1/instagram/posts/{id}`

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`.

## Example request

```bash
curl --request DELETE \
  --url 'https://app.whatsetter.com/api/v1/instagram/posts/{id}' \
  --header 'Authorization: Bearer ws_live_…'
```

## Responses

### 200: Cancelled

```json
{
  "data": {
    "id": "",
    "status": "cancelled"
  }
}
```

### 401: Missing, unknown or revoked API key

```json
{
  "error": {
    "code": "",
    "message": ""
  }
}
```

### 403: 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)

```json
{
  "error": {
    "code": "",
    "message": ""
  }
}
```

### 404: Resource not found in this workspace

```json
{
  "error": {
    "code": "",
    "message": ""
  }
}
```

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


Source: https://docs.whatsetter.com/api-reference/operations/cancelinstagrampost/
