Public API overview

Base URL, auth header, and what you can automate.

Base URL:

Production: https://socioi.com/api/public/v1
Local: http://localhost:4000/public/v1

All Public API routes require authentication:

Authorization: si_live_YOUR_KEY

Authorization: pos_YOUR_OAUTH_TOKEN

Bearer prefix is optional for both.

Endpoint groups

Group	Paths
Health	`/is-connected`
Channels	`/channels`, `/channels/quota`, `/channels/connect/:provider`, plus Bluesky / Lemmy / Nostr / Dev.to / Hashnode / ListMonk / WordPress / Moltbook / Farcaster / Telegram / Mastodon / Discord / Slack special routes
Posts	`/posts`, schedule, status, delete
Media	upload-url, confirm, upload-from-url, delete

Prefer an AI agent? Use the MCP server (https://socioi.com/mcp/mcp) or the AI Agents CLI instead of calling REST by hand — same workspace and Public API under the hood.

Mental model

Your script / product
        │  si_live_ or pos_
        ▼
   Socioi Public API
        │  (Socioi holds social tokens)
        ▼
  Facebook · Instagram · TikTok · …

Continue with Authentication.