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

Local development: http://localhost:8000

Authorization

See Authentication for Bearer format, scopes, and plan gates.

Canonical API prefixes

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

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:

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