Skip to main content
The Postsiva REST API is a JSON HTTP API scoped to workspaces. Use a workspace API key for server-to-server and automation integrations.

Base URL

https://backend.postsiva.com
Local development: http://localhost:8000

Authorization

X-API-Key: psk_live_YOUR_WORKSPACE_KEY
Content-Type: application/json
See Authentication for Bearer format, scopes, and plan gates.

Canonical API prefixes

PrefixUse
/unified/post/*Publish, draft, schedule
/unified/oauth/*Connect accounts
/unified/posts, /unified/drafts, /unified/scheduled-postsLists and queue
/unified/comments, /unified/analyticsInbox and metrics
/unified/user-profiles/Connected account metadata
/media/*Upload and media library (not under /unified)
/workspace-agent/website/chatLangGraph agent
/unified/gpt-actions/{tool}ChatGPT Actions
Legacy paths: Older mobile/extension builds may still call /social/post, /social/oauth, or /social/drafts. The backend temporarily rewrites these to /unified/*. New integrations must use /unified/* only.
JWT-only route: GET /unified/ai-autoreplier/admin/overview (cross-workspace admin).

Endpoint groups

GroupPrefix / pathDescription
PostingPOST /unified/post/*Text, image, video, carousel — publish, draft, schedule
PostsGET /unified/postsRecent posts per platform
Scheduled/unified/scheduled-postsQueue CRUD, publish-now
Drafts/unified/draftsDraft CRUD, publish, schedule
AnalyticsGET /unified/analyticsCross-platform totals
Comments/unified/commentsList and reply
OAuth/unified/oauth/*Connect, status, disconnect
ProfilesGET /unified/user-profiles/Connected account metadata
Media/media/*Upload images and videos
AI content/unified/content, /unified/imageGenerate copy and images
AI Watcher/unified/ai-autoreplier/*Comment watch, leads, auto-reply
Agent chatPOST /workspace-agent/website/chatFull LangGraph agent
GPT ActionsPOST /unified/gpt-actions/{tool}ChatGPT Custom GPT mirror

REST vs MCP vs GPT Actions

  • REST — you choose the endpoint and body
  • MCP — the AI agent picks tools (publish, get_user_posts, …)
  • GPT Actions — REST POST per tool for ChatGPT (no web search tool)

Timestamps

Use ISO 8601 UTC for scheduling:
2026-07-10T14:30:00Z

OpenAPI

ChatGPT Actions schema: GET /openapi/chatgpt-actions.json

Next

AI content

Generate copy and images

Agent chat

LangGraph workspace agent

GPT Actions

ChatGPT Custom GPT mirror

MCP overview

Agent integration