Skip to main content
The MagicPost REST API powers both the MagicPost web app and the MCP server. Use it directly when you want to script MagicPost operations without an LLM in the loop.

​
Base URL

(Staging: https://apistaging.magicpost.in/api/v1)

​
Authentication

All endpoints require a Bearer token in the Authorization header — see Authentication for how to create one.
There is one exception: the /api/v1/api-keys/* management endpoints (used by the MagicPost web UI) use cookie session auth instead. You can’t use these from a script — generate keys from the web UI.

​
Response shape

Success responses are tailored to each endpoint. Error responses follow a common shape — see Errors.

​
Rate limits

  • 60 req/min per token by default
  • 5 req/min per token on /refresh-posts (it hits LinkedIn)
Window resets at the start of every wall-clock minute. Exceeding returns HTTP 429.

​
Endpoints

API keys

Manage your tokens. Cookie auth only.

Metrics

Pull analytics summary, trigger refresh.

Posts

List, fetch, create, update, delete (soft).

Scheduling

Schedule, cancel, publish-now.

​
OpenAPI

An auto-generated OpenAPI 3 spec is in progress. In the meantime, the per-endpoint pages list path, method, params, and response shape.