Getting Started
Examples
Request examples for publishing, scheduling, uploads, and canceling.
Publish now
curl https://postmantis.com/api/v1/posts \
-H "Authorization: Bearer $POSTMANTIS_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"post": { "body": "Launch is live." },
"profiles": ["PROFILE_ID"]
}'Schedule for later
curl https://postmantis.com/api/v1/posts \
-H "Authorization: Bearer $POSTMANTIS_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"post": { "body": "Launch tomorrow.", "scheduledAt": "2026-03-30T12:00:00Z" },
"profiles": ["PROFILE_ID"]
}'Multipart media upload with post
curl https://postmantis.com/api/v1/posts \
-H "Authorization: Bearer $POSTMANTIS_API_KEY" \
-F 'payload={"post":{"body":"Launch image"},"profiles":["PROFILE_ID"],"media":[{"fileField":"media0","alt":"Launch card"}]}' \
-F '[email protected];type=image/png'Reschedule
curl -X PATCH https://postmantis.com/api/v1/posts/POST_ID \
-H "Authorization: Bearer $POSTMANTIS_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "post": { "scheduledAt": "2026-03-31T12:00:00Z" } }'Cancel scheduled post
curl -X POST https://postmantis.com/api/v1/posts/POST_ID/cancel \
-H "Authorization: Bearer $POSTMANTIS_API_KEY"