> ## 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.

# Remove a creator from a program

> Remove an approved creator from a program, as the dashboard's Remove does. The creator's place on the program ends. Their videos and posts stay, and money already paid is never taken back.

The creator id is opaque, so the request must also repeat the names from `GET` on this path. A request whose names do not match its ids removes nobody. When another approved creator on the program has the same name, the request must also name a handle that only this creator has on the program, on any platform.

The removal is recorded with your API key as the actor and your `reason`. The creator does not see the reason. Use the application routes for a creator who is not approved yet.



## OpenAPI

````yaml /api-reference/openapi.json post /programs/{id}/creators/{creatorId}/remove
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}/remove:
    post:
      tags:
        - Creators
      summary: Remove a creator from a program
      description: >-
        Remove an approved creator from a program, as the dashboard's Remove
        does. The creator's place on the program ends. Their videos and posts
        stay, and money already paid is never taken back.


        The creator id is opaque, so the request must also repeat the names from
        `GET` on this path. A request whose names do not match its ids removes
        nobody. When another approved creator on the program has the same name,
        the request must also name a handle that only this creator has on the
        program, on any platform.


        The removal is recorded with your API key as the actor and your
        `reason`. The creator does not see the reason. Use the application
        routes for a creator who is not approved yet.
      parameters:
        - $ref: '#/components/parameters/ScopeParam'
        - in: path
          name: id
          required: true
          schema:
            type: string
            format: uuid
          description: The program id
        - in: path
          name: creatorId
          required: true
          schema:
            type: string
          description: The creator `id` from `GET /creators`
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - reason
                - paymentAction
                - creatorName
                - programName
              properties:
                reason:
                  type: string
                  maxLength: 500
                  description: >-
                    Why the creator is removed. Stored on the removal's record;
                    the creator does not see it.
                  example: No posts in 30 days
                paymentAction:
                  type: string
                  enum:
                    - keep
                    - remove
                  description: >-
                    No default. `keep`: the creator is still paid for work
                    already done. `remove`: the creator's unpaid earnings on the
                    program are cancelled. `remove` is allowed only when the
                    preview returns `canRemovePayments: true`.
                creatorName:
                  type: string
                  maxLength: 300
                  description: >-
                    `creatorName` from the preview. Letter case and spaces are
                    ignored.
                  example: Ava Stone
                programName:
                  type: string
                  maxLength: 300
                  description: >-
                    `programName` from the preview. Letter case and spaces are
                    ignored.
                  example: Fall Launch
                creatorHandle:
                  type: string
                  maxLength: 300
                  description: >-
                    Required only when the preview returns `sameNameCreators`:
                    one of this creator's `handles` that no creator in
                    `sameNameCreators` has. A leading `@` and letter case are
                    ignored.
                  example: '@avastone'
      responses:
        '200':
          description: The creator was removed
          content:
            application/json:
              schema:
                type: object
                properties:
                  programId:
                    type: string
                    format: uuid
                  programName:
                    type: string
                  creatorId:
                    type: string
                  creatorName:
                    type: string
                  removed:
                    type: boolean
                    enum:
                      - true
                  paymentAction:
                    type: string
                    enum:
                      - keep
                      - remove
                  warnings:
                    type: array
                    items:
                      type: string
                    description: A product order whose cancellation needs a check
        '400':
          description: The request body is invalid
        '401':
          description: Unauthorized - API key is invalid
        '403':
          description: The program is read-only for this API key
        '404':
          description: >-
            The program is not visible to this key, or the creator is not an
            approved creator in it. A creator already removed returns 404
        '409':
          description: >-
            Nobody was removed. The body has `error` and `code`:
            `removal_names_do_not_match` (`creatorName` or `programName` is not
            the name of its id; the message gives the names of the ids),
            `removal_name_ambiguous` (another approved creator has the name, and
            `creatorHandle` is missing or not a handle that only this creator
            has), or `pending_payouts_must_be_kept` (`remove` is not allowed;
            use `keep`).
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.