PublishQPublishQ

Delete post

Deletes a scheduled or draft post by its ID. Returns no body on success.

DELETE
/posts/{id}

Deletes a scheduled or draft post by its ID. Returns no body on success.

Authorization

ApiKeyAuth
AuthorizationBearer <token>

PublishQ API key sent as Authorization: Bearer pq_live_....

In: header

Path Parameters

id*string
Formatuuid

Response Body

application/json

application/json

application/json

application/json

curl -X DELETE "https://publishq.com/api/v1/posts/1b5c779b-d7de-4e4e-bf55-95b9317b6d93"
Empty

{
  "error": {
    "title": "Unauthorized",
    "status": 401,
    "code": "missing_auth",
    "message": "Missing Authorization header",
    "instance": "/api/v1/posts"
  }
}

{
  "error": {
    "title": "Forbidden",
    "status": 403,
    "code": "insufficient_scope",
    "message": "Missing required scope: posts:write",
    "instance": "/api/v1/posts/1b5c779b-d7de-4e4e-bf55-95b9317b6d93"
  }
}
{
  "error": {
    "title": "Not Found",
    "status": 404,
    "code": "post_not_found",
    "message": "Post not found",
    "instance": "/api/v1/posts"
  }
}
{
  "error": {
    "title": "Too Many Requests",
    "status": 429,
    "code": "rate_limit_exceeded",
    "message": "Too Many Requests",
    "instance": "/api/v1/posts/1b5c779b-d7de-4e4e-bf55-95b9317b6d93",
    "details": {
      "retryAfter": 60
    }
  }
}