Update a script
Change a script: send only the fields to change, or markdown to replace its title, hooks and body. The next match re-scores posts against it. Changing the tag moves the script's posts to the new tag. Pausing it (active: false) keeps the posts it has.
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"application/json- body
code?stringLetters, digits, - and _. Unique in the brand, ignoring case.
1 <= length <= 12title?string1 <= length <= 200hooks?array<>items <= 20body?stringlength <= 20000tagName?stringMoves the script's posts to this tag.
1 <= length <= 60active?booleanmarkdown?stringReplaces the title, hooks and body with the script in this 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 code stays unless code is sent.
1 <= length <= 100000Success.
application/json- response
id*stringcode*stringShort label, unique in the brand (S1, 3A).
title*stringhooks*array<>body*stringWhat the video says after the hook, as Markdown.
active*booleanMatched against new posts. A paused script keeps the posts it has.
tag*|The tag matched sets get.
source*|Where the script came from: a Notion page ("notion"), a Google Doc ("gdoc") or text ("text"). Null when it was written field by field.
posts*integerPosts that follow it.
-9007199254740991 <= value <= 9007199254740991waitingForPick*integerPosts waiting for a person whose best guess is this script.
-9007199254740991 <= value <= 9007199254740991updatedAt*stringwarnings*array<string>curl -X PATCH 'https://example.com/api/v1/brands/string/scripts/string' \ -H 'Content-Type: application/json' \ -d '{}'{ "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", "warnings": [ "string" ]}List match runs GET
The brand's last 20 match runs, newest first: Match now and nightly. Follow a run started with POST /brands/{brandId}/scripts/match here until its status is done.
Tag a set POST
Put tags on a set (pair): the set's pay then counts under them in spend by tag, and every video in the set gets them too, so views by tag agree. A tag it already has changes nothing. A tag id that isn't the brand's answers 404 and changes nothing. To put one tag on many sets, use brand.tag.sets.add. Returns the set's tags afterwards.