Settle a post's script
Answer for a post as a person would in Match history. pick, not_campaign and leave apply to the post's whole set, and no match changes them; the set's tag follows. hand_back undoes that: the set waits for the next match.
bearerAuth videos:writeAuthorizationBearer <token>Personal access token. Scopes: account:read, creator:read, creator:earnings, managed:read, coach:read, brand:read, creators:read, videos:read, analytics:read, onboarding:read, onboarding:signatures, engagement:read, support:read, integrations:read, payouts:read, funds:read, billing:read, groups:write, videos:write, onboarding:write, sync:write, payouts:write.
Scope: videos:write
brandId*stringA brand id from GET /me or GET /creator/brands.
1 <= lengthvideoId*stringA video id (videoId) from GET /brands/{brandId}/scripts/matches or GET /brands/{brandId}/videos.
1 <= lengthapplication/json- body
action*string"pick": set scriptId; "not_campaign": no script; "leave": keep it as it is; "hand_back": let matching decide again.
"pick""not_campaign""leave""hand_back"scriptId?stringWith pick: the script to set.
1 <= lengthSuccess.
application/json- response
ok*booleanvideoId*stringcurl -X POST 'https://example.com/api/v1/brands/string/scripts/matches/string' \ -H 'Content-Type: application/json' \ -d '{ "action": "pick"}'{ "ok": true, "videoId": "string"}Match posts to scripts now POST
Match now, the same as the button on the Scripts page: read the transcripts of posts from the last 30 days and of unpaid cycles, score them against the active scripts, and set, keep or flag each one. It runs in the background: this answers 202 at once; follow it with GET /brands/{brandId}/scripts/runs. A match already running answers 202 with alreadyRunning. Without an active script it answers 400. Takes no body.
List matched posts GET
Each matched post's script, status, lead and best guesses, newest post first. `filter` narrows it: "open" (waiting for a pick), "auto" (set by matching), "person" (set by a person), "skipped" (not campaign or nothing to read) or "all". `counts` has every filter's total.