Skip to main content
POST
/
api
/
v2
/
streams
/
{streamId}
/
re-test
Re-test a stream
curl --request POST \
  --url https://api.example.com/api/v2/streams/{streamId}/re-test
Re-classifies cached followers against the campaign’s segments. No new follower fetch. Consumes monthly re-test budget per account (MONTHLY_RETEST_BUDGET_BY_TIER).

​
Body (all optional)

FieldTypeDescription
accountIdnumberRe-test all pairs on this account
segmentIdnumberRe-test all pairs using this segment
Combine for one specific pair, or send {} to re-test every pair in the stream.

​
Response

{
  "queued": [
    { "pairId": 101, "trackedAccountId": 7, "segmentId": 12, "runId": 234 }
  ],
  "skipped": [
    { "pairId": 102, "trackedAccountId": 8, "reason": "budget_exhausted" }
  ]
}
skipped.reason is one of free_tier, budget_exhausted, account_sleeping. Poll each queued runId with GET /streams//runs/.

​
Auth

Bearer or session cookie.