---
title: "Unassign creators from campaign"
method: POST
path: "/creators/campaigns/unassign"
tags: ["Creators"]
---

# Unassign creators from campaign

`POST /creators/campaigns/unassign`

## Request

- Base URL: `https://viral.app/api/v1`
- URL: `https://viral.app/api/v1/creators/campaigns/unassign`
- Auth: API key in header `x-api-key`

Sets or replaces the scheduled end of the current campaign assignment for one or more creators. All creators must share the same campaign. `endBasis` `prev`, `current` or `next` end after a full billing period; `today` ends the assignment at the end of today and `custom` on the `endDate` named, any day. An end inside a billing period makes that period the assignment's final one, cut to the end day, and due the day after like any other (pay it, or cancel it if the creator was paid another way). An end on or before the assignment start clears it entirely; removeCanceledWindows consents to deleting canceled payout windows overlapping a cleared assignment (paid windows always block). Once a cut final period is paid or canceled the end cannot move anymore.

## Request body

- object
  - `creatorIds` string[], required
  - `endBasis` 'prev' | 'current' | 'next' | 'custom' | 'today', required
  - `endDate` string, date
  - `removeCanceledWindows` boolean

## Response `200`

OK

- object
  - `updated` integer, required
  - `removedCanceledWindows` integer, required

## Other responses

- `400`: 400
- `401`: 401
- `402`: 402
- `404`: 404
- `408`: 408
- `409`: 409
- `429`: 429
- `500`: 500

---

[API](https://skmtc.dev/viral/apis/viral-app-api.md) · [All operations](https://skmtc.dev/viral/apis/viral-app-api/llms.txt) · [OpenAPI document](https://skmtc.dev/viral/apis/viral-app-api/revisions/31e97fa79ef1?raw)