REST API

Two interfaces, one backend. Agents talk to the MCP server; your own services call the REST API. Both carry the same key, the same scopes, and the same encrypted token vault — Modiva still holds every OAuth credential.

Base URL   https://api.modiva.ai/v1
Auth       Authorization: Bearer mk_live_…

Endpoints

GET/connectionsList connected accounts

POST/social/postsCreate or schedule a post

GET/social/analyticsUnified insights across platforms

GET/ecommerce/ordersList & filter store orders

POST/ecommerce/orders/:id/refundIssue a refund

POST/connect/urlStart a hosted OAuth flow

Example

curl https://api.modiva.ai/v1/social/posts \
  -H "Authorization: Bearer mk_live_…" \
  -H "Content-Type: application/json" \
  -d '{ "profile_id": "acme", "text": "Launching today" }'