Bloss Docs

Put a tag on many sets

Developers
POST
/brands/{brandId}/tags/{tagId}/sets

Put one tag on up to 200 sets at once, the same as brand.set.tags.add on each: every video in those sets gets the tag too. Sets that already have it are unchanged, so tagged can be lower than matched. Set ids that aren't the brand's are ignored (matched counts the brand's). An unknown tag answers 404.

Authorization

bearerAuth videos:write
headerAuthorizationBearer <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

Path Parameters

brandId*string

A brand id from GET /me or GET /creator/brands.

Length1 <= length
tagId*string

A tag id from GET /brands/{brandId}/tags.

Length1 <= length

Request Body

application/json
  1. body
setIds*array<>

1–200 set ids (setId) from GET /brands/{brandId}/sets. Ids that aren't this brand's sets are ignored.

Items1 <= items <= 200

Response Body

Success.

application/json
  1. response
tagged*number

Sets that didn't have the tag and now do.

matched*number

The brand's sets among the ids sent.

requested*number

Distinct set ids sent.

curl -X POST 'https://example.com/api/v1/brands/string/tags/string/sets' \  -H 'Content-Type: application/json' \  -d '{  "setIds": [    "string"  ]}'
{  "tagged": 0,  "matched": 0,  "requested": 0}

Was this page helpful?

Start a full sync POST

Start a full sync of the brand, the same as the Full sync button in the app: fetch every active and trial creator's latest posts and views from their platforms, pair the videos into sets, recalculate pay on every unpaid payout cycle, and refresh eligibility. It takes minutes (longer for big brands), so it runs in the background: this answers 202 as soon as it's started. Follow it with brand.sync.get (GET /brands/{brandId}/sync). A sync already running for the brand (including the nightly one, or one started in the app) answers 409 conflict. A new start within 15 minutes of the last sync finishing answers 429 rate_limited with Retry-After. Takes no body.

Take a tag off many sets DELETE

Take one tag off up to 200 sets at once, the same as brand.set.tags.remove on each: the sets lose the tag, their videos keep it. Sets without the tag, and ids that aren't the brand's, change nothing. An unknown tag answers 404.