List scripts
The brand's scripts: each one's code, title, hooks, body, tag and source, how many posts follow it and how many wait for a pick, plus the brand words and whether matching runs nightly. A post follows a script when matching finds it does; its set then gets the script's tag.
bearerAuth videos:readAuthorizationBearer <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:read
brandId*stringA brand id from GET /me or GET /creator/brands.
1 <= lengthSuccess.
application/json- response
data*array<>settings*curl -X GET 'https://example.com/api/v1/brands/string/scripts'{ "data": [ { "id": "string", "code": "string", "title": "string", "hooks": [ { "text": "string", "verbal": "string" } ], "body": "string", "active": true, "tag": { "id": "string", "name": "string" }, "source": { "kind": "notion", "url": "string", "readAt": "string" }, "posts": -9007199254740991, "waitingForPick": -9007199254740991, "updatedAt": "string" } ], "settings": { "brandWords": [ "string" ], "nightlyEnabled": true }}Import scripts from docs or Markdown POST
Create or update up to 25 scripts at once from Notion pages, Google Docs or Markdown. Each document's code comes from its title ("(3A) …"): a code a script already has updates that script's title, hooks and body and keeps its tag; anything else becomes a new script. Bloss keeps a copy of each document to show with the script. Preview first with dryRun: it reads every document and says what each would become, without saving. Documents that can't be read (private, not found) come back with an error; the rest still import.
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.