# Deleting Posts
Remove one or multiple posts—of any state—from your workspace. This endpoint enforces role-based permissions and state-specific restrictions.
### Requirements
* **Authentication**: Bearer API token
* **Scope**: `posts`
* **Headers**:
* `Authorization: Bearer-API YOUR_API_KEY`
* `Publer-Workspace-Id: YOUR_WORKSPACE_ID`
### Endpoint
```http
DELETE /api/v1/posts
```
Deletes one or more posts based on the provided IDs.
#### Query Parameters
Parameter
Type
Required
Description
post_ids
array
Yes
Array of post IDs to delete
### Authorization Rules
* You may delete:
* Posts you created
* Posts in workspaces you own
* Posts in workspaces where you have “post action” access
* **Private drafts**: only their creator can delete
* **Published posts requiring approval**: restricted roles (e.g., editors) cannot delete
* **Queued posts** (except reminders): cannot be deleted
Pending-state deletions trigger a notification to the creator before removal.
## Delete Multiple Posts
> Deletes one or multiple posts from the workspace specifying exact post IDs. Authorization rules apply to ensure users can only delete posts they have permission to delete.
```json
{"openapi":"3.1.1","info":{"title":"Publer API","version":"1.0.0"},"tags":[{"name":"Posts","description":"Endpoints for managing social media posts"}],"servers":[{"url":"https://app.publer.com/api/v1"}],"security":[{"BearerApiAuth":[]}],"components":{"securitySchemes":{"BearerApiAuth":{"type":"apiKey","name":"Authorization","in":"header","description":"API key authentication. Format: \"Bearer-API YOUR_API_KEY\""}},"schemas":{"401ErrorResponseWithWorkspace":{"type":"object","properties":{"errors":{"type":"array","description":"List of error messages","items":{"type":"string"}}}},"403ErrorResponse":{"type":"object","properties":{"errors":{"type":"array","description":"List of error messages","items":{"type":"string"}}}}}},"paths":{"/posts":{"delete":{"summary":"Delete Multiple Posts","description":"Deletes one or multiple posts from the workspace specifying exact post IDs. Authorization rules apply to ensure users can only delete posts they have permission to delete.","tags":["Posts"],"parameters":[{"schema":{"type":"string"},"name":"Publer-Workspace-Id","in":"header","description":"ID of the workspace containing the posts","required":true},{"schema":{"type":"array","items":{"type":"string"}},"style":"form","explode":true,"name":"post_ids","in":"query","description":"Array of post IDs to delete. Can include both MongoDB ObjectIDs and PostgreSQL IDs.","required":true}],"responses":{"200":{"description":"Posts deleted successfully","content":{"application/json":{"schema":{"type":"object","properties":{"deleted_ids":{"type":"array","description":"Array of IDs of successfully deleted posts","items":{"type":"string"}}}}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401ErrorResponseWithWorkspace"}}}},"403":{"description":"Permission denied or missing required scope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403ErrorResponse"}}}}}}}}}
```
### Related Resources
* [List Posts API](/docs/api-reference/posts.md) - Retrieve and filter posts
* [Update Posts API](/docs/posting/update-posts.md) - Modify existing posts
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://publer.com/docs/posting/delete-posts.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.