Skip to content
Docs

Ask Socialit support questions (failed posts, account connection, API usage). Answers are generated with Claude, grounded on the Socialit documentation and on the context you pass (post, account, failed request). Runs are asynchronous: poll the run or listen to support_run.completed.

Base URLhttps://api.socialit.com/v1AuthenticationErrorsRate limits3 endpointsMCP toolset support

List a thread's support answers

GET/support/runs

With thread_id: the whole thread, oldest first. Without: every run of the workspace, newest first.

Access: readZernio: GET /v1/support/runs

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

Query parameters

pageintegerdefault: 1

Page number

≥ 1

limitintegerdefault: 20

Items per page (max 100)

1–100

sortstring

created_at

orderstring

ascdesc

matchstring

Combine filters with AND (default) or OR

allor

thread_idstring

≤ 80 characters

statusstring

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 19 item attributes
objectstring

support_run

idstring
thread_idstring
statusstring

queuedrunningcompletedneeds_humanfailed

stop_reasonstring | null
questionstring
answerstring | null
diagnosisobject | null
Show 5 child attributes
categorystring

account_connectioncontent_rejectedrate_limitedplatform_issuesocialit_issuebillingconfigurationhow_toother

causestring | null
fix_stepsarray of string
docs_linksarray of string
who_must_actstring

integratorend_usersocialitplatformnone

sourcesarray of object
Show 3 item attributes
titlestring
pathstring
urlstring | null
contextobject
Show 4 child attributes
post_idstring | null
account_idstring | null
profile_idstring | null
request_idstring | null
modelstring | null
usageobject
Show 4 child attributes
input_tokensinteger
output_tokensinteger
cache_read_tokensinteger
cache_write_tokensinteger
cost_usdnumber
max_cost_usdnumber
support_ticketobject | null
Show 1 child attributes
opened_atstring
poll_after_secondsinteger | null
created_atstring (date-time) | null
started_atstring (date-time) | null
finished_atstring (date-time) | null
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/support/runs
curl "https://api.socialit.com/v1/support/runs" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200
{
  "object": "list",
  "data": [
    {
      "object": "support_run",
      "id": "string",
      "thread_id": "string",
      "status": "queued",
      "stop_reason": "string",
      "question": "string",
      "answer": "string",
      "diagnosis": {
        "category": "account_connection",
        "cause": "string",
        "fix_steps": [
          "string"
        ],
        "docs_links": [
          "string"
        ],
        "who_must_act": "integrator"
      },
      "sources": [
        {
          "title": "string",
          "path": "string",
          "url": "https://example.com"
        }
      ],
      "context": {
        "post_id": "string",
        "account_id": "string",
        "profile_id": "string",
        "request_id": "string"
      },
      "model": "string",
      "usage": {
        "input_tokens": 1,
        "output_tokens": 1,
        "cache_read_tokens": 1,
        "cache_write_tokens": 1
      },
      "cost_usd": 1.5,
      "max_cost_usd": 1.5,
      "support_ticket": {
        "opened_at": "2026-10-13T09:00:00.000Z"
      },
      "poll_after_seconds": 1,
      "created_at": "2026-10-13T09:00:00.000Z",
      "started_at": "2026-10-13T09:00:00.000Z",
      "finished_at": "2026-10-13T09:00:00.000Z"
    }
  ],
  "page": 1,
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}

Ask a support question

POST/support/runs

Returns 202 with a queued run. 503 support_unavailable when the server has no Anthropic API key; 409 support_run_in_progress (one active run per thread); 429 support_active_runs_limit (3 at once).

Access: writeIdempotency-KeyZernio: POST /v1/support/runs

Try it with MCPAsk your agent to call ask-support-question (toolset support)Set up MCP

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

Body object

messagestringrequired

1–10000 characters

thread_idstring

≤ 80 characters

contextobject
Show 4 child attributes
post_idstring
account_idstring
profile_idstring
request_idstring

≤ 128 characters

max_cost_usdnumber

0.05–3

Returns object

objectstring

support_run

idstring
thread_idstring
statusstring

queuedrunningcompletedneeds_humanfailed

stop_reasonstring | null
questionstring
answerstring | null
diagnosisobject | null
Show 5 child attributes
categorystring

account_connectioncontent_rejectedrate_limitedplatform_issuesocialit_issuebillingconfigurationhow_toother

causestring | null
fix_stepsarray of string
docs_linksarray of string
who_must_actstring

integratorend_usersocialitplatformnone

sourcesarray of object
Show 3 item attributes
titlestring
pathstring
urlstring | null
contextobject
Show 4 child attributes
post_idstring | null
account_idstring | null
profile_idstring | null
request_idstring | null
modelstring | null
usageobject
Show 4 child attributes
input_tokensinteger
output_tokensinteger
cache_read_tokensinteger
cache_write_tokensinteger
cost_usdnumber
max_cost_usdnumber
support_ticketobject | null
Show 1 child attributes
opened_atstring
poll_after_secondsinteger | null
created_atstring (date-time) | null
started_atstring (date-time) | null
finished_atstring (date-time) | null

Responses

  • 202Accepted
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/support/runs
curl -X POST "https://api.socialit.com/v1/support/runs" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "message": "string",
    "thread_id": "string",
    "context": {
      "post_id": "string",
      "account_id": "string"
    },
    "max_cost_usd": 0.05
  }'
Response · 202
{
  "object": "support_run",
  "id": "string",
  "thread_id": "string",
  "status": "queued",
  "stop_reason": "string",
  "question": "string",
  "answer": "string",
  "diagnosis": {
    "category": "account_connection",
    "cause": "string",
    "fix_steps": [
      "string"
    ],
    "docs_links": [
      "string"
    ],
    "who_must_act": "integrator"
  },
  "sources": [
    {
      "title": "string",
      "path": "string",
      "url": "https://example.com"
    }
  ],
  "context": {
    "post_id": "string",
    "account_id": "string",
    "profile_id": "string",
    "request_id": "string"
  },
  "model": "string",
  "usage": {
    "input_tokens": 1,
    "output_tokens": 1,
    "cache_read_tokens": 1,
    "cache_write_tokens": 1
  },
  "cost_usd": 1.5,
  "max_cost_usd": 1.5,
  "support_ticket": {
    "opened_at": "2026-10-13T09:00:00.000Z"
  },
  "poll_after_seconds": 1,
  "created_at": "2026-10-13T09:00:00.000Z",
  "started_at": "2026-10-13T09:00:00.000Z",
  "finished_at": "2026-10-13T09:00:00.000Z"
}

Get a support answer

GET/support/runs/{id}

Access: readZernio: GET /v1/support/runs/{runId}

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

Path parameters

idstringrequired

supportRun id (srun_…)

1–80 characters

Returns object

objectstring

support_run

idstring
thread_idstring
statusstring

queuedrunningcompletedneeds_humanfailed

stop_reasonstring | null
questionstring
answerstring | null
diagnosisobject | null
Show 5 child attributes
categorystring

account_connectioncontent_rejectedrate_limitedplatform_issuesocialit_issuebillingconfigurationhow_toother

causestring | null
fix_stepsarray of string
docs_linksarray of string
who_must_actstring

integratorend_usersocialitplatformnone

sourcesarray of object
Show 3 item attributes
titlestring
pathstring
urlstring | null
contextobject
Show 4 child attributes
post_idstring | null
account_idstring | null
profile_idstring | null
request_idstring | null
modelstring | null
usageobject
Show 4 child attributes
input_tokensinteger
output_tokensinteger
cache_read_tokensinteger
cache_write_tokensinteger
cost_usdnumber
max_cost_usdnumber
support_ticketobject | null
Show 1 child attributes
opened_atstring
poll_after_secondsinteger | null
created_atstring (date-time) | null
started_atstring (date-time) | null
finished_atstring (date-time) | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/support/runs/{id}
curl "https://api.socialit.com/v1/support/runs/srun_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200
{
  "object": "support_run",
  "id": "string",
  "thread_id": "string",
  "status": "queued",
  "stop_reason": "string",
  "question": "string",
  "answer": "string",
  "diagnosis": {
    "category": "account_connection",
    "cause": "string",
    "fix_steps": [
      "string"
    ],
    "docs_links": [
      "string"
    ],
    "who_must_act": "integrator"
  },
  "sources": [
    {
      "title": "string",
      "path": "string",
      "url": "https://example.com"
    }
  ],
  "context": {
    "post_id": "string",
    "account_id": "string",
    "profile_id": "string",
    "request_id": "string"
  },
  "model": "string",
  "usage": {
    "input_tokens": 1,
    "output_tokens": 1,
    "cache_read_tokens": 1,
    "cache_write_tokens": 1
  },
  "cost_usd": 1.5,
  "max_cost_usd": 1.5,
  "support_ticket": {
    "opened_at": "2026-10-13T09:00:00.000Z"
  },
  "poll_after_seconds": 1,
  "created_at": "2026-10-13T09:00:00.000Z",
  "started_at": "2026-10-13T09:00:00.000Z",
  "finished_at": "2026-10-13T09:00:00.000Z"
}