Skip to content
Docs

Focus mode: everything a network's API allows for one connected account. The manifest lists the resources (with JSON schemas for tables and forms); the generic operations run them. Typed per-network aliases live under the "Focus · " tags.

Base URLhttps://api.socialit.com/v1AuthenticationErrorsRate limits10 endpointsMCP toolset focus

List networks with Focus mode

GET/focus/platforms

Networks that publish a focus module, with their navigation groups, resource / action counts and MCP toolset.

Access: read

Try it with MCPAsk your agent to call list-focus-platforms (toolset focus)Set up MCP

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 8 item attributes
objectstring

focus_platform

platformstring
labelstring
groupsarray of object
Show 3 item attributes
keystring
labelstring
iconstring | null
resource_countinteger
action_countinteger
operation_countinteger
toolsetstring
pageintegerrequired
limitintegerrequired
totalinteger | null
has_morebooleanrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/focus/platforms
curl "https://api.socialit.com/v1/focus/platforms" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200
{
  "object": "list",
  "data": [
    {
      "object": "focus_platform",
      "platform": "string",
      "label": "string",
      "groups": [
        {
          "key": "string",
          "label": "string",
          "icon": "string"
        }
      ],
      "resource_count": 1,
      "action_count": 1,
      "operation_count": 1,
      "toolset": "string"
    }
  ],
  "page": 1,
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}

Get the Focus manifest of an account

GET/accounts/{accountId}/focus

Resources of the account's network with their JSON schemas, operations and actions. Availability is computed from the account's granted scopes; missing_scopes and reconnect_url (connect with scope_set=focus) tell how to unlock the rest.

Access: read

Try it with MCPAsk your agent to call get-focus-manifest (toolset focus)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Returns object

objectstring

focus_manifest

platformstring
labelstring
accountobject
Show 10 child attributes
objectstring

account

idstring
platformstring
account_typestring
usernamestring | null
display_namestring | null
avatar_urlstring | null
statusstring

activeneeds_reconnect

profile_idstring | null
scopesarray of string
groupsarray of object
Show 3 item attributes
keystring
labelstring
iconstring | null
resourcesarray of object
Show 17 item attributes
keystring
labelstring
descriptionstring | null
iconstring | null
groupstring
viewstring
singletonboolean
id_fieldstring
title_fieldstring | null
columnsarray of string | null
fieldsobject
operationsobject
Show 5 child attributes
listobject
Show 4 child attributes
availableboolean
queryobject | null
bodyobject | null
summarystring | null
getobject
Show 4 child attributes
availableboolean
queryobject | null
bodyobject | null
summarystring | null
createobject
Show 4 child attributes
availableboolean
queryobject | null
bodyobject | null
summarystring | null
updateobject
Show 4 child attributes
availableboolean
queryobject | null
bodyobject | null
summarystring | null
deleteobject
Show 4 child attributes
availableboolean
queryobject | null
bodyobject | null
summarystring | null
actionsarray of object
Show 7 item attributes
namestring
labelstring
targetstring

itemcollection

destructiveboolean
bodyobject | null
summarystring | null
availableboolean
availableboolean
missing_scopesarray of string
docsstring | null
typed_pathstring | null
missing_scopesarray of string
needs_reconnectboolean
reconnect_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/focus
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/focus" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200
{
  "object": "focus_manifest",
  "platform": "string",
  "label": "string",
  "account": {
    "object": "account",
    "id": "string",
    "platform": "string",
    "account_type": "string",
    "username": "string",
    "display_name": "string",
    "avatar_url": "https://example.com",
    "status": "active",
    "profile_id": "string",
    "scopes": [
      "string"
    ]
  },
  "groups": [
    {
      "key": "string",
      "label": "string",
      "icon": "string"
    }
  ],
  "resources": [
    {
      "key": "string",
      "label": "string",
      "description": "string",
      "icon": "string",
      "group": "string",
      "view": "string",
      "singleton": true,
      "id_field": "string",
      "title_field": "string",
      "columns": [
        "string"
      ],
      "fields": {},
      "operations": {
        "list": {
          "available": true,
          "query": {},
          "body": {},
          "summary": "string"
        },
        "get": {
          "available": true,
          "query": {},
          "body": {},
          "summary": "string"
        },
        "create": {
          "available": true,
          "query": {},
          "body": {},
          "summary": "string"
        },
        "update": {
          "available": true,
          "query": {},
          "body": {},
          "summary": "string"
        },
        "delete": {
          "available": true,
          "query": {},
          "body": {},
          "summary": "string"
        }
      },
      "actions": [
        {
          "name": "string",
          "label": "string",
          "target": "item",
          "destructive": true,
          "body": {},
          "summary": "string"
        }
      ],
      "available": true,
      "missing_scopes": [
        "string"
      ],
      "docs": "string",
      "typed_path": "string"
    }
  ],
  "missing_scopes": [
    "string"
  ],
  "needs_reconnect": true,
  "reconnect_url": "https://example.com"
}

List focus items (or get a singleton resource)

GET/accounts/{accountId}/focus/{resource}

Lists items of a resource with cursor pagination (cursor = previous next_cursor). Other query parameters are validated against the resource's operations.list.query schema and passed to the network. For singleton resources (singleton: true in the manifest) returns the object.

Access: read

Try it with MCPAsk your agent to call list-focus-items (toolset focus)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

resourcestringrequired

Focus resource key from the manifest (e.g. videos)

1–80 characters · pattern ^[a-z0-9]+(?:-[a-z0-9]+)*$

Query parameters

cursorstring

Opaque cursor from next_cursor

limitinteger

Page size (the network may cap it lower)

1–500

Returns object

One of 2 shapes

object: "list" object

objectstringrequired

list

dataarray of objectrequired
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Option 2 object

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/focus/{resource}
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/focus/RESOURCE" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200
{
  "object": "list",
  "data": [
    {}
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}

Create a focus item

POST/accounts/{accountId}/focus/{resource}

Body validated against the resource's operations.create.body schema.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call create-focus-item (toolset focus)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

resourcestringrequired

Focus resource key from the manifest (e.g. videos)

1–80 characters · pattern ^[a-z0-9]+(?:-[a-z0-9]+)*$

Headers

Idempotency-Keystring

Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

≤ 255 characters

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/focus/{resource}
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/focus/RESOURCE" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 201
{}

Update a singleton focus resource

PATCH/accounts/{accountId}/focus/{resource}

For resources with singleton: true (channel settings, chat info, …). Body validated against operations.update.body.

Access: write

Try it with MCPAsk your agent to call update-focus-singleton (toolset focus)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

resourcestringrequired

Focus resource key from the manifest (e.g. videos)

1–80 characters · pattern ^[a-z0-9]+(?:-[a-z0-9]+)*$

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
PATCH/accounts/{accountId}/focus/{resource}
curl -X PATCH "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/focus/RESOURCE" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200
{}

Delete or reset a singleton focus resource

DELETE/accounts/{accountId}/focus/{resource}

Access: write

Try it with MCPAsk your agent to call delete-focus-singleton (toolset focus)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

resourcestringrequired

Focus resource key from the manifest (e.g. videos)

1–80 characters · pattern ^[a-z0-9]+(?:-[a-z0-9]+)*$

Returns object

objectstringrequired

focus_item

platformstringrequired
resourcestringrequired
idstring | nullrequired
deletedbooleanrequired
resultany

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
DELETE/accounts/{accountId}/focus/{resource}
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/focus/RESOURCE" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200
{
  "object": "focus_item",
  "platform": "string",
  "resource": "string",
  "id": "string",
  "deleted": true,
  "result": null
}

Get a focus item

GET/accounts/{accountId}/focus/{resource}/{itemId}

Query parameters are passed to the network (validated against operations.get.query when present).

Access: read

Try it with MCPAsk your agent to call get-focus-item (toolset focus)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

resourcestringrequired

Focus resource key from the manifest (e.g. videos)

1–80 characters · pattern ^[a-z0-9]+(?:-[a-z0-9]+)*$

itemIdstringrequired

The network's id of the item

1–512 characters

Query parameters

typeany
additionalPropertiesany

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/focus/{resource}/{itemId}
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/focus/RESOURCE/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200
{}

Update a focus item

PATCH/accounts/{accountId}/focus/{resource}/{itemId}

Body validated against operations.update.body.

Access: write

Try it with MCPAsk your agent to call update-focus-item (toolset focus)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

resourcestringrequired

Focus resource key from the manifest (e.g. videos)

1–80 characters · pattern ^[a-z0-9]+(?:-[a-z0-9]+)*$

itemIdstringrequired

The network's id of the item

1–512 characters

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
PATCH/accounts/{accountId}/focus/{resource}/{itemId}
curl -X PATCH "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/focus/RESOURCE/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200
{}

Delete a focus item

DELETE/accounts/{accountId}/focus/{resource}/{itemId}

Access: write

Try it with MCPAsk your agent to call delete-focus-item (toolset focus)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

resourcestringrequired

Focus resource key from the manifest (e.g. videos)

1–80 characters · pattern ^[a-z0-9]+(?:-[a-z0-9]+)*$

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

objectstringrequired

focus_item

platformstringrequired
resourcestringrequired
idstring | nullrequired
deletedbooleanrequired
resultany

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
DELETE/accounts/{accountId}/focus/{resource}/{itemId}
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/focus/RESOURCE/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200
{
  "object": "focus_item",
  "platform": "string",
  "resource": "string",
  "id": "string",
  "deleted": true,
  "result": null
}

Run a focus action

POST/accounts/{accountId}/focus/{resource}/{itemId}/{action}

Item actions (target: "item") take the item id; collection actions (target: "collection") and actions of singleton resources use - as itemId (…/focus/{resource}/-/{action}). Body validated against the action's body schema.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call run-focus-action (toolset focus)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

resourcestringrequired

Focus resource key from the manifest (e.g. videos)

1–80 characters · pattern ^[a-z0-9]+(?:-[a-z0-9]+)*$

itemIdstringrequired

The network's id of the item

1–512 characters

actionstringrequired

Action name from the manifest (e.g. transition)

1–80 characters · pattern ^[a-z0-9]+(?:-[a-z0-9]+)*$

Headers

Idempotency-Keystring

Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

≤ 255 characters

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/focus/{resource}/{itemId}/{action}
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/focus/RESOURCE/ITEM_ID/ACTION" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}