Concepts
Words Socioi uses in the app and API.
| Term | Meaning |
|---|---|
| Workspace / Organization | Billing and channel container for your team |
| Channel | A connected social account (Facebook Page, Instagram, etc.) |
| Post | Content + targets + schedule status |
| Post target | Per-channel publish row (status, external id, settings) |
| Media asset | Uploaded file referenced by posts |
| API key | Org credential for Public API, MCP, and Agents CLI (si_live_) |
| OAuth app | Third-party REST client (pca_ / pcs_) |
| Access token | User-granted Public API token (pos_) |
| MCP | Model Context Protocol for AI hosts (https://socioi.com/mcp) |
| MCP access token | Claude / ChatGPT grant (mcp_at_ / mcp_rt_) |
| AI Agents CLI | socioi shell CLI for Claude Code / OpenClaw (docs) |
| Provider settings | Per-channel options on a post target, e.g. YouTube title / description / audience or TikTok visibility (details) |
| TikTok Direct Post | Socioi publishes the video straight to the TikTok profile (postMode: "direct") |
| TikTok inbox upload | Socioi sends the video to the creator's TikTok inbox; they finish and post it in the TikTok app (postMode: "inbox") |
Post and target statuses
| Status | Meaning |
|---|---|
DRAFT | Saved, not queued |
SCHEDULED | Queued; the worker publishes it at scheduledAt (also used while targets are still being retried) |
PUBLISHED | Every target published |
FAILED | At least one target failed permanently (see the target's errorMessage) |
A target fails after 3 attempts, or immediately for permanent errors (missing permissions, unsupported media). If publishing is interrupted mid-upload (for example a deploy), the target is marked FAILED with "Publishing was interrupted and its outcome is unknown" rather than retried, because the network may already have accepted it — check the channel before re-posting.