PostMantis
API Reference

API Overview

Public API for posting, scheduling, uploads, and delivery inspection.

PostMantis public API lives under /api/v1.

Core flow

  1. List connected profiles with GET /api/v1/profiles.
  2. Upload media with POST /api/v1/uploads, then POST /api/v1/uploads/complete; posts reference returned artifact IDs. For direct file posts, send multipart/form-data with a payload JSON field and named file parts.
  3. Create immediate or scheduled work with POST /api/v1/posts.
  4. Read state with GET /api/v1/posts/{postId}.
  5. Cancel future scheduled work with POST /api/v1/posts/{postId}/cancel.

Post states

StateMeaning
pendingAccepted. Worker has not settled work yet.
scheduledWaiting for scheduled time or delivery completion.
completedAll deliveries settled.
canceledFuture delivery was canceled.

Endpoints

  • GET /api/v1/posts
  • POST /api/v1/posts
  • GET /api/v1/posts/{postId}
  • PATCH /api/v1/posts/{postId} — edit future scheduled post body/media/provider options/schedule
  • POST /api/v1/posts/{postId}/cancel
  • POST /api/v1/uploads
  • POST /api/v1/uploads/complete
  • GET /api/v1/publish/logs

Create is async acceptance. Read post later for final delivery result.

Examples

Request examples for publishing, scheduling, uploads, and canceling.

List posts GET

Returns posts visible to the authenticated caller, with optional filtering by status, profile, provider, and scheduled date range. Supports paginated iteration.

On this page

Core flowPost statesEndpoints