---
title: "Unassign designations from a campaign"
method: POST
path: "/v1/campaigns/{id}/designations/unassign"
tags: ["Campaigns"]
---

# Unassign designations from a campaign

`POST /v1/campaigns/{id}/designations/unassign`

This request allows you to unassign designations from a campaign. Each item is processed independently; the response reports the per-item outcome. Only base campaign types are supported.

## Path parameters

- `id` string, required

## Request body

- UnassignDesignationsRequest — Contains the request parameters required for detaching designations from a campaign.
  - `items` UnassignDesignationItem[], required — An array of designations to unassign.
    - `id` string, required — Unique identifier of the designation, formatted as E[A-Z\d]{7}.
  - `livemode` boolean — Specifies whether the request is executed in live or test mode. Required for API keys created after 30th January 2026.

## Response `200`

On success, the API returns the overall status and a per-item result array describing which designations were detached.

- UnassignDesignationsResponse — Provides the per-item results of a batch designation detachment request.
  - `results` UnassignDesignationResultItem[], required — An array containing the result for each item in the request, in the same order.
    - `error` UnassignDesignationError, required — Describes the error that prevented detaching a single designation.
      - `code` 'designation_not_found' | 'designation_not_attached', required — Error code.
      - `message` string, required — Error message.
    - `id` string, required — Unique identifier of the designation, formatted as E[A-Z\d]{7}.
  - `status` 'complete' | 'partial' | 'failed', required — Status of the bulk operation.

## Other responses

- `403` — Forbidden. The API key does not have permission to manage campaigns.
- `404` — Resource not found.
- `422` — Duplicated ids: The request contains duplicated ids. Campaign type not supported. Last designation for frequency: at least one designation must remain for every active frequency.

---

[API](https://skmtc.net/fundraiseup/apis/fundraise-up-api.md) · [All operations](https://skmtc.net/fundraiseup/apis/fundraise-up-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/fundraiseup/fundraise-up-api/revisions/f59881dadecd/schema)