/api/v2/posts/{postId}DELETEDeletes a post. Pass
deleteFromPlatforms=true to also remove
the published post from the platforms themselves. Removing content
from social platforms requires an active subscription.Authorization
apiKey *Bearer <token>
Akarso API key from the dashboard. Token in: header
Path Parameters
postId *string
Post ID
Query Parameters
deleteFromPlatforms?boolean
Also delete the published post from the platforms themselves
Response
200
success *boolean
platforms?object[] | null
Per-platform deletion outcome when deleting from the platforms
400 · Invalid request body, path, or query parameters
error *string
Human-readable error message
code?string
Machine-readable error code
message?string
Additional error details
401 · Missing or invalid API key
error *string
Human-readable error message
code?string
Machine-readable error code
message?string
Additional error details
402
error *string
Human-readable error message
code?string
Machine-readable error code
message?string
Additional error details
subscribeUrl?string
URL to start a subscription
404 · Resource not found
error *string
Human-readable error message
code?string
Machine-readable error code
message?string
Additional error details
409 · Post is currently publishing and cannot be deleted
error *string
Human-readable error message
code?string
Machine-readable error code
message?string
Additional error details
429 · Upstream rate limit reached
error *string
Human-readable error message
code?string
Machine-readable error code
message?string
Additional error details
502 · Upstream platform request failed
error *string
Human-readable error message
code?string
Machine-readable error code
message?string
Additional error details
503 · Upstream service temporarily unavailable or submission outcome unknown
error *string
Human-readable error message
code?string
Machine-readable error code
message?string
Additional error details