# 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.

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](/docs/ui-modes/)); the API exposes the same resources in two shapes.

| Shape | Reference | MCP toolset | Use it for |
|---|---|---|---|
| **Generic operations** | [Focus](/docs/api-reference/focus/) (10 endpoints) | `focus` | Building a UI from the manifest, one integration for every network |
| **Typed operations** | [Focus · YouTube](/docs/api-reference/focus-youtube/), [Focus · X](/docs/api-reference/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

```bash
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_failed` with `errors` per field). Fields with `format: "media-id"` take Socialit media IDs (`med_…`).
- Lists use cursors: pass `next_cursor` back as `cursor`.
- 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 as `youtube-videos-list` or `youtube-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[].available` is `false` when the account lacks the resource's scopes, and `resources[].missing_scopes` lists them.
- The top-level `missing_scopes` is the union, and `reconnect_url` is a ready-made link: `GET /v1/connect/youtube?reconnect_account_id=sa_…&scope_set=focus`.
- Calling a resource without its scopes answers `403 missing_scopes` with `missing_scopes` and `reconnect_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}`](/docs/connecting-accounts/#oauth-redirect).

> **Network limits apply:** Focus calls go straight to the network, so its quotas apply: YouTube quota units, X pay-per-use credits (`402 x_credits_required` without prepaid credits), Reddit QPM. Rate-limited calls answer `429 platform_rate_limited` with `Retry-After`.

## 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:

```text
https://api.socialit.com/mcp?toolsets=focus,focus_youtube
```

See [MCP server](/docs/mcp/#toolsets).

---

Source: https://socialit.com/docs/focus-mode/
