---
title: "Delete a group of draft/scheduled posts"
method: DELETE
path: "/api/v1/posts/group/{group}"
tags: ["Posts"]
---

# Delete a group of draft/scheduled posts

`DELETE /api/v1/posts/group/{group}`

## Request

- Base URL: `https://www.poster.ly`
- URL: `https://www.poster.ly/api/v1/posts/group/{group}`
- Auth: HTTP bearer

Delete all draft/scheduled/failed/paused posts that match a caller-defined group_id, post_group_id, api_group_id, or release_id metadata value. Published, publishing, and processing posts block the deletion and are returned in the 409 response.

## Path parameters

- `group` string, required

## Request body

- DeletePostGroupRequest
  - `confirm` boolean, required: Must be true to delete all deletable posts in the group.

## Response `200`

Group posts deleted successfully

- DeletePostGroupResponse
  - `deleted` boolean, required
  - `group_id` string, required
  - `deleted_post_ids` integer[], required
  - `deleted_count` integer, required
  - `removed_queued_jobs` integer

## Other responses

- `400`: Validation error
- `401`: Invalid or missing API key
- `404`: Resource not found
- `409`: Validation error
- `429`: Too many requests

---

[API](https://skmtc.dev/poster/apis/posterly-api.md) · [All operations](https://skmtc.dev/poster/apis/posterly-api/llms.txt) · [OpenAPI document](https://skmtc.dev/poster/apis/posterly-api/revisions/60be02a61f95?raw)