Skip to main content
POST
/
api
/
v2
/
streams
/
{streamId}
/
run
Run a stream now
curl --request POST \
  --url https://api.example.com/api/v2/streams/{streamId}/run
Triggers a sync (X-API follower fetch + classification) across every active pair in the stream. Consumes one daily sync slot per account. For re-test-only (cached profiles, no follower fetch) use Re-test a stream.

​
Body

None.

​
Response

{
  "queued": [
    { "trackedAccountId": 7, "syncRunId": 123 }
  ],
  "skipped": [
    { "trackedAccountId": 8, "reason": "budget_exhausted" }
  ]
}
skipped.reason is one of budget_exhausted (daily sync cap hit) or account_sleeping. Poll each queued runId with GET /streams//runs/.

​
Errors

CodeHTTPWhen
Stream not found404
Stream is archived400Restore the stream first

​
Auth

Bearer or session cookie.