API ReferencePosts
Cancel a scheduled post
Cancels a scheduled post before it settles. Use cancel when you want to stop future delivery while preserving the record and its history. Use delete only for drafts that should be discarded entirely.
Cancels a scheduled post before it settles. Use cancel when you want to stop future delivery while preserving the record and its history. Use delete only for drafts that should be discarded entirely.
Authorization
BearerAuth AuthorizationBearer <token>
API key from the PostMantis dashboard.
In: header
Path Parameters
postId*string
Post identifier.
Format
uuidResponse Body
application/json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/json
curl -X POST "https://loading/api/posts/74d6f3d9-6b68-4a2d-9d89-c4510a08ff42/cancel"{ "data": { "id": "804f2fcc-b4fa-4cdd-964d-9d0cc58d72a1", "body": "Big announcement tomorrow.", "status": "canceled", "draft": false, "scheduledAt": "2026-03-30T10:00:00Z", "createdAt": "2026-03-29T09:30:00Z", "updatedAt": "2026-03-29T09:35:00Z", "canceledAt": "2026-03-29T09:35:00Z", "media": [ { "id": "f4a457b3-99ad-47d7-beb8-a64d8efdc6ef", "status": "processed", "contentType": null, "url": null, "assetId": "8f5f3f18-3cf7-4aa8-a0ea-6fd204d4c4f1", "alt": "Launch card", "errorMessage": null } ], "deliveries": [ { "profileId": "4339a6bc-9cd3-455e-8f91-df8bc63f12d7", "provider": "x", "profileName": "Julius", "status": "pending", "scheduledAt": "2026-03-30T10:00:00Z", "publishedAt": null, "failedAt": null, "providerPostId": null, "url": null, "errorMessage": null }, { "profileId": "8d3ef50f-98d9-4a44-8cf7-0b7fb53ab0a8", "provider": "instagram", "profileName": "Brand", "status": "pending", "scheduledAt": "2026-03-30T10:00:00Z", "publishedAt": null, "failedAt": null, "providerPostId": null, "url": null, "errorMessage": null } ] }}{ "type": "https://postmantis.com/problems/unauthorized", "title": "Unauthorized", "status": 401, "detail": "Missing or invalid API key.", "code": "unauthorized"}{ "type": "https://postmantis.com/problems/forbidden", "title": "Forbidden", "status": 403, "detail": "The authenticated API key is not allowed to perform this action.", "code": "forbidden"}{ "type": "https://postmantis.com/problems/not-found", "title": "Not found", "status": 404, "detail": "Post was not found for the authenticated account.", "code": "notFound"}{ "type": "https://postmantis.com/problems/conflict", "title": "Conflict", "status": 409, "detail": "Only scheduled posts that have not settled can be canceled.", "code": "conflict"}{ "error": "Too Many Requests"}