Delete a post and its history, including every event about it
Delete a post and its history, including every event about it (admin)
Every request sends Authorization: Bearer ...: the access token in local mode, an API key stk_... in cloud mode. Use Send to try it against your cloud instance with your API key.
Unlike DELETE /v1/posts/{id} (which keeps the post's events as history), purge also deletes
the post's events and their webhook deliveries (including pending ones), its media when no
other post uses them, and cached idempotent responses containing it. One content-free
post.purged event is recorded. Finished workspace exports are expired.
AuthorizationBearer <token>API key (stk_...), or in the Community Edition the access token (stk_local_...)
id*stringIdempotency-Key?stringReplays the stored response when the same key is repeated with the same method, path,
query string and body within 24 hours (422 idempotency_mismatch with a different
request, 409 idempotency_in_progress while the first one runs). Not applied to
multipart uploads or to responses that carry a secret.
length <= 200OK
application/json- response
post_id*stringevents_deleted*integermedia_deleted*integerMedia files deleted because no other post used them
curl -X POST 'https://staqly.example.com/v1/posts/string/purge'{ "post_id": "string", "events_deleted": 0, "media_deleted": 0}