Delete a script
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.
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 <= lengthscriptId*stringA script id from GET /brands/{brandId}/scripts.
1 <= lengthdryRun?string"true": run every check and return { dryRun: true, wouldChange } without changing anything.
"true""false"Success.
application/json- response
deleted*booleanid*stringcurl -X DELETE 'https://example.com/api/v1/brands/string/scripts/string'{ "deleted": true, "id": "string"}Create a script POST
Create one script, as fields (title, hooks, body) or 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 "---". The next match scores posts against it. A code another script uses answers 409 conflict: update that script instead. For many scripts, or Notion pages and Google Docs, use POST /brands/{brandId}/scripts/import.
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.