Get a post
Returns one post with media and per-delivery details when the full post is visible to the authenticated API key.
Returns one post with media and per-delivery details when the full post is visible to the authenticated API key.
Authorization
BearerAuth API key from the PostMantis dashboard.
In: header
Path Parameters
Post identifier.
uuidResponse Body
application/json
application/problem+json
application/problem+json
application/json
curl -X GET "https://postmantis.com/api/posts/74d6f3d9-6b68-4a2d-9d89-c4510a08ff42"{ "data": { "id": "1d2aafec-bf13-4ea4-b271-6f9ac1e9d069", "body": "Draft copy for approval.", "status": "draft", "draft": true, "scheduled_at": null, "created_at": "2026-03-29T09:30:00Z", "updated_at": "2026-03-29T09:30:00Z", "canceled_at": null, "media": [], "deliveries": [ { "profile_id": "4339a6bc-9cd3-455e-8f91-df8bc63f12d7", "provider": "x", "profile_name": "Julius", "status": "pending", "scheduled_at": null, "published_at": null, "failed_at": null, "provider_post_id": null, "url": null, "error_message": null } ] }}{ "type": "https://postmantis.com/problems/unauthorized", "title": "Unauthorized", "status": 401, "detail": "Missing or invalid API key.", "code": "unauthorized"}{ "type": "https://postmantis.com/problems/post-not-found", "title": "Post not found", "status": 404, "detail": "Post was not found for the authenticated account.", "code": "post_not_found"}{ "error": "Too Many Requests"}Create a post POST
Creates a draft, scheduled post, or immediate publish request. Non-draft writes are accepted in `pending` first and then advanced asynchronously by the publishing workflow. The request must include `post.body`, `media`, or both. Draft requests must not include `post.scheduled_at`.
Update a post PATCH
Updates a draft post, or reschedules a scheduled post when the request only changes `post.scheduled_at` and every delivery is still pending. PATCH must change at least one field, and `post.draft` cannot be changed through this endpoint.