Bloss Docs

Close a submission without a decision

Developers
POST
/brands/{brandId}/onboarding/submissions/{submissionId}/close

Close an open submission without approving or rejecting it, and without emailing the creator. They can start again from a link. An already closed or decided submission answers 409 conflict.

Authorization

bearerAuth onboarding: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: onboarding:write

Path Parameters

brandId*string

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

Length1 <= length
submissionId*string

An id from GET /brands/{brandId}/onboarding/submissions.

Length1 <= length

Request Body

application/json
  1. body
reason?|

An internal reason, up to 1,000 characters.

Response Body

Success.

application/json
  1. response
id*string
status*string
curl -X POST 'https://example.com/api/v1/brands/string/onboarding/submissions/string/close' \  -H 'Content-Type: application/json' \  -d '{}'
{  "id": "string",  "status": "closed"}

Was this page helpful?

Approve a submission: the creator joins the brand POST

Approve a submission that's awaiting approval (in a flow with completion mode "approval"). This admits the creator: they join the brand as a creator, go into the flow's join group (or the link's default group), get their social accounts from the form tracked, and are emailed. Refused with 409 conflict when it isn't awaiting approval, when its link is full (raise the link's maxUses, then approve again), or when the creator hasn't verified their email yet. Approving again after a partial failure finishes the job.

Move a task's deadline POST

Set a new deadline for an open task of a submission in progress. Send exactly one of: `addHours` (1–1440, added to the current deadline, or to now if it has passed), `dueAt` (an ISO-8601 instant), or `date` and `time` (the brand's time zone). It must be in the future. The due-soon and overdue emails are sent again for the new deadline.