Skip to main content
POST
Preview a creator step update

Authorizations

x-api-key
string
header
required

API key created in Dashboard → Settings → Developer

Path Parameters

id
string
required

ID of the program

creatorId
string
required

Creator id from GET /creators

Query Parameters

scope
enum<string>
default:company

Choose the data scope. company (default) limits results to the API key company's data. agency includes the parent agency and its linked brands. scope=agency requires a parent agency key; other keys receive 403.

Available options:
company,
agency

Body

application/json
intent
object
required

What you pick. A step moves the creator there with its pay, Discord, trial, and round-robin coach. A payscale changes the pay, and moves the creator to the one step with that pay when exactly one step has it. A coach changes only the coach.

applyToPastVideos
boolean
default:false

Also count the creator's submitted, unpaid videos that a re-price at the new pay would change.

trialEndsAt
string<date-time>

When the change starts a trial: the moment the trial ends. ISO-8601 with Z or a UTC offset, for example 2026-12-05T23:59:59-05:00. It must be in the future and at most 366 days ahead. The trial then ends at this moment, not on the program's day or video limit. Leave it out to keep the program's limit.

Response

The proposed changes

programId
string
creatorId
string
version
integer

Send it with the update.

changes
object[]
startsTrial
boolean

The change starts a trial, so the update can take trialEndsAt.

pastVideos
object | null

With applyToPastVideos: the submitted videos a re-price would change.