Import scripts from docs or Markdown
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.
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 <= lengthdryRun?string"true": run every check and return { dryRun: true, wouldChange } without changing anything.
"true""false"application/json- body
urls?array<>Notion pages shared to the web, or Google Docs anyone with the link can view.
items <= 25markdown?stringOne or more scripts as Markdown in the Bloss script format: a top-level heading with the code in brackets and the title ("# (S5) I paid $40 in late fees"), a "## Hook 1", "## Hook 2"… section per hook with "On screen: …" and "Said: …" lines, and a "## Script" section with what the video says, one line per sentence. Sections like "## Demo direction" are kept for people and not matched. Several scripts can go in one text, separated by a line of "---".
1 <= length <= 400000tagName?stringOptional tag for new scripts. Without it, each new script gets a tag named after it.
1 <= length <= 60Success.
application/json- response
results*array<>curl -X POST 'https://example.com/api/v1/brands/string/scripts/import' \ -H 'Content-Type: application/json' \ -d '{}'{ "results": [ { "label": "string", "ok": true, "action": "created", "id": "string", "code": "string", "warnings": [ "string" ], "error": "string" } ]}Delete a script DELETE
Delete a script. Posts it was the answer for lose their script and the next match decides them again. Its tag stays on those posts; delete the tag to remove it.
List scripts GET
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.