Guide
Focus mode
Everything a network's API allows for one connected account, through a manifest, generic operations and typed per-network endpoints, with scope upgrades on demand.
Updated Oct 14, 2026
Publishing and the inbox cover what every network has in common. Focus mode covers the rest: everything a network’s API allows for one connected account, such as YouTube playlists, captions and live broadcasts, Reddit mod queues, Discord roles or Mastodon filters. The app renders it as a full-screen workspace per account (see UI modes); the API exposes the same resources in two shapes.
| Shape | Reference | MCP toolset | Use it for |
|---|---|---|---|
| Generic operations | Focus (10 endpoints) | focus |
Building a UI from the manifest, one integration for every network |
| Typed operations | Focus · YouTube, Focus · X, … (one tag per network) | focus_youtube, focus_x, … |
Documented, typed calls and SDKs; agents working on one network |
Both run through the same dispatcher, return the same shapes and need the same scopes.
1. Read the manifest
curl https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/focus \
-H "Authorization: Bearer $SOCIALIT_API_KEY"The manifest lists the account’s resources (videos, live-broadcasts, playlists, …). Each one has JSON-schema fields, the operations it supports (list, get, create, update, delete) with their query and body schemas, named actions (go-live, set-thumbnail, …), whether it is a singleton, and its typed_path. GET /v1/focus/platforms lists the networks with a focus module and their toolsets.
2. Call a resource
Generic routes take the resource key and action name from the manifest:
| Operation | Generic | Typed (YouTube example) |
|---|---|---|
| List | GET /v1/accounts/{accountId}/focus/{resource} |
GET /v1/accounts/{accountId}/youtube/videos |
| Get | GET …/focus/{resource}/{itemId} |
GET …/youtube/videos/{itemId} |
| Create | POST …/focus/{resource} |
POST …/youtube/playlists |
| Update | PATCH …/focus/{resource}/{itemId} |
PATCH …/youtube/videos/{itemId} |
| Delete | DELETE …/focus/{resource}/{itemId} |
DELETE …/youtube/playlists/{itemId} |
| Item action | POST …/focus/{resource}/{itemId}/{action} |
POST …/youtube/live-broadcasts/{itemId}/go-live |
| Collection action | POST …/focus/{resource}/-/{action} |
POST …/youtube/videos/{action} |
Singleton resources (a channel’s settings, a Discord server’s welcome screen) have no item ID: GET, PATCH and DELETE the resource path itself.
- Query parameters and bodies are validated against the resource’s schemas (
422 validation_failedwitherrorsper field). Fields withformat: "media-id"take Socialit media IDs (med_…). - Lists use cursors: pass
next_cursorback ascursor. - Items are returned as the network object, in snake_case, never stripped of extra fields.
- Typed operation IDs and MCP tools follow
<network>-<resource>-<operation>, such asyoutube-videos-listoryoutube-live-broadcasts-go-live.
3. Upgrade scopes when you need them
Accounts connect with the core scopes for publishing, inbox and analytics. Focus resources often need more. The manifest tells you:
resources[].availableisfalsewhen the account lacks the resource’s scopes, andresources[].missing_scopeslists them.- The top-level
missing_scopesis the union, andreconnect_urlis a ready-made link:GET /v1/connect/youtube?reconnect_account_id=sa_…&scope_set=focus. - Calling a resource without its scopes answers
403 missing_scopeswithmissing_scopesandreconnect_url.
Send the user through reconnect_url (it keeps the account, its profile and history, and never counts against your allowance). New connections can ask for everything up front with scope_set=focus on GET /v1/connect/{platform}.
MCP
The generic tools are in toolset focus; each network’s typed tools are in focus_<network>. There are nearly 2,000 typed tools, so select the networks you need:
https://api.socialit.com/mcp?toolsets=focus,focus_youtubeSee MCP server.