> ## Documentation Index
> Fetch the complete documentation index at: https://docs.launchpointhq.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Change a creator pay structure

> Move a creator onto another payscale on a Canvas program, as the dashboard pay picker does. Only videos the creator submits after the move use the new payscale, unless `applyToPastVideos` is true. Any move off the trial payscale ends the trial; `graduate` also records that the creator passed it. A creator who signed the program contract is asked to sign the new pay terms again.

`applyToPastVideos` re-prices every unpaid video the creator submitted on the program, in a background run that cannot be cancelled. The run can add money to the creator's wallet, and that money is not taken back.



## OpenAPI

````yaml /api-reference/openapi.json put /programs/{id}/creators/{creatorId}/pay-structure
openapi: 3.0.4
info:
  title: Launchpoint Public API
  version: 1.0.0
  description: >-
    **Private preview.** The Launchpoint Public API is in private preview and
    available only to trusted partners we work with directly. Access is not
    self-serve. Email hi@launchpointhq.com to ask about access.


    REST API for Launchpoint brands and agencies. Use an API key in the
    `x-api-key` header to authenticate.


    ## Requirements

    - Public API access must be enabled for the company. During private preview,
    access is limited to trusted partners.

    - Create and manage API keys in Dashboard → Settings → Developer.


    ## Creator privacy

    - Responses never include creator email addresses. Creator phone numbers are
    null when no number is stored or the workspace does not have access to
    creator contact details.


    ## Rate limits

    - Default: **200 requests per minute** per API key.

    - Approved partner accounts: **400 requests per minute**.

    - Every response includes `X-RateLimit-Limit`, `X-RateLimit-Remaining`, and
    `X-RateLimit-Reset`. Requests over the limit return `429`.


    ## Errors

    - Errors use `{ "error": "<message>" }` with the matching HTTP status. Some
    endpoints also include a `code`.


    ## Timestamps

    - Timestamps are Unix timestamps in milliseconds unless a field says
    otherwise.


    ## Pagination

    - Most list endpoints accept `page` and `limit` and return `{ data, page,
    total }`. Some also return `totalPages`.

    - `scope=company` is the default. A parent agency key can pass
    `scope=agency` on supported routes to include its own data and linked
    brands.
servers:
  - url: https://dashboard.launchpointhq.com/api/v1
    description: Live API server
security:
  - apiKeyAuth: []
tags:
  - name: Deals
    description: Public creator opportunities across Launchpoint
  - name: Programs
    description: Programs and campaign management
  - name: Posts
    description: Posts and social content
  - name: Analytics
    description: KPIs and performance metrics
  - name: Payouts
    description: Payouts, balances, and pending creator funds
  - name: Contracts
    description: Contracts and creator agreements
  - name: Creators
    description: Creator profiles and metrics
  - name: Applications
    description: Creator applications to Canvas programs
  - name: Messages
    description: Read and send creator messages
  - name: Onboarding
    description: 'Creator onboarding: status, messages, and proof review'
  - name: Media review
    description: >-
      Review the media creators send before they post: queue, status, approve,
      and reject
paths:
  /programs/{id}/creators/{creatorId}/pay-structure:
    put:
      tags:
        - Programs
      summary: Change a creator pay structure
      description: >-
        Move a creator onto another payscale on a Canvas program, as the
        dashboard pay picker does. Only videos the creator submits after the
        move use the new payscale, unless `applyToPastVideos` is true. Any move
        off the trial payscale ends the trial; `graduate` also records that the
        creator passed it. A creator who signed the program contract is asked to
        sign the new pay terms again.


        `applyToPastVideos` re-prices every unpaid video the creator submitted
        on the program, in a background run that cannot be cancelled. The run
        can add money to the creator's wallet, and that money is not taken back.
      parameters:
        - $ref: '#/components/parameters/ScopeParam'
        - in: path
          name: id
          required: true
          schema:
            type: string
          description: ID of the program
        - in: path
          name: creatorId
          required: true
          schema:
            type: string
          description: Creator id from `GET /creators`
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - payscaleId
              properties:
                payscaleId:
                  type: string
                  nullable: true
                  description: >-
                    A payscale id from `GET /programs/{id}/pay-structures`, or
                    `null` for Default. Not the trial payscale.
                move:
                  type: string
                  enum:
                    - assign
                    - graduate
                  default: assign
                  description: >-
                    `graduate` takes a creator off the trial payscale and
                    records that they passed it.
                applyToPastVideos:
                  type: boolean
                  default: false
                  description: >-
                    Also re-price the creator's submitted, unpaid videos. Cannot
                    be combined with `graduate`.
      responses:
        '200':
          description: The creator was moved
          content:
            application/json:
              schema:
                type: object
                properties:
                  programId:
                    type: string
                  creatorId:
                    type: string
                  payscaleId:
                    type: string
                    nullable: true
                  resetRunId:
                    type: string
                    nullable: true
                    description: >-
                      The background re-price run, when `applyToPastVideos` is
                      true.
        '400':
          description: The program is not a Canvas program, or the request is invalid
        '403':
          description: This key cannot change the program
        '404':
          description: No program, creator, or post was found
        '409':
          description: The change cannot be made now
components:
  parameters:
    ScopeParam:
      in: query
      name: scope
      required: false
      schema:
        type: string
        enum:
          - company
          - agency
        default: company
      description: >-
        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`.
  securitySchemes:
    apiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key
      description: API key created in Dashboard → Settings → Developer

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.