API Reference

Mavrilo REST API

Programmatically manage your social media, AI content, analytics, and more.

Base URL: https://mavrilo.in/api/v1

Generate API keys from Developer settings inside your account

Pass your key as Authorization: Bearer <token> on every request

1,000 requests/hour per API key. Limits vary by plan.

Example request

curl -X GET https://mavrilo.in/api/v1/posts \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"

Response envelope

{ "success": true, "data": <payload>, "message": "...", "timestamp": "..." }

All responses are wrapped in this envelope. Your actual payload is inside data.

Endpoints

POST/api/v1/auth/registerCreate a new account

POST/api/v1/auth/loginSign in and receive JWT tokens

POST/api/v1/auth/refreshRefresh an expired access token

POST/api/v1/auth/logoutInvalidate the current session

GET/api/v1/postsList all scheduled and published posts

POST/api/v1/postsCreate a new post or schedule it

PATCH/api/v1/posts/:idUpdate a post

DELETE/api/v1/posts/:idDelete a post

POST/api/v1/posts/:id/publishPublish a post immediately

GET/api/v1/social-accountsList connected social accounts

DELETE/api/v1/social-accounts/:idDisconnect a social account

POST/api/v1/ai/generateGenerate text content (caption, hashtags, etc.)

POST/api/v1/ai/generate-imageGenerate an AI image

GET/api/v1/ai/historyList past AI generations

GET/api/v1/analytics/overviewAccount-level analytics overview

GET/api/v1/analytics/postsPer-post performance metrics

GET/api/v1/inboxList inbox conversations

GET/api/v1/inbox/:id/messagesGet messages in a conversation

POST/api/v1/inbox/:id/replySend a reply in a conversation

PATCH/api/v1/inbox/:id/statusUpdate conversation status

GET/api/v1/brandsList all workspaces

POST/api/v1/brandsCreate a new workspace

PATCH/api/v1/brands/:idUpdate a workspace

DELETE/api/v1/brands/:idDelete a workspace

Generate your API key from the Developer section in your dashboard.