Skip to main content

Documentation Index

Fetch the complete documentation index at: https://dev.magicpost.in/llms.txt

Use this file to discover all available pages before exploring further.

The MagicPost REST API powers both the MagicPost web app and the MCP server. Use it directly when you want to script MagicPost operations — automations, integrations, or any workflow where you don’t need an LLM in the loop.

​
Base URL

The production base URL for all REST API requests is: 
https://api.magicpost.in/api/v1
Use the staging environment for testing against non-production data: 
https://apistaging.magicpost.in/api/v1

​
Authentication

All endpoints require a Personal Access Token passed as a Bearer token in the Authorization header. See Authentication for how to create one. To verify your token is valid, call the verification endpoint: 
curl https://api.magicpost.in/api/v1/auth/verify \
  -H "Authorization: Bearer mp_xxx"
The /api/v1/api-keys/* management endpoints are an exception — they use cookie session auth instead of Bearer tokens and are only callable from the MagicPost web app. Generate and revoke keys from the Settings → API & MCP tab.

​
Rate limits

ScopeLimit
All endpoints (default)60 requests/min per token
POST /refresh-posts5 requests/min per token
Rate limit windows reset at the start of every wall-clock minute. Exceeding the limit returns HTTP 429.

​
Endpoints

Posts

List, fetch, create, and update your LinkedIn posts.

Scheduling

Schedule, cancel, and immediately publish posts.

Metrics

Pull an analytics summary and trigger a LinkedIn data refresh.

API Keys

Manage your Personal Access Tokens. Cookie auth only.

​
OpenAPI spec

An auto-generated OpenAPI 3 spec is in progress. In the meantime, each endpoint group page documents the path, method, parameters, and response shape in full.