---
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`

## Request

- Base URL: `https://api.fundraiseup.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.fundraiseup.com/v1/campaigns/{id}/designations/unassign`
- Auth: HTTP bearer

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.

## Changes

- **2026-08-04** `12bc2c7512aa`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/fundraiseup/apis/fundraise-up-api/changes/v1/campaigns/:id/designations/unassign/post.md)

---

[API](https://skmtc.dev/fundraiseup/apis/fundraise-up-api.md) - [All operations](https://skmtc.dev/fundraiseup/apis/fundraise-up-api/llms.txt) - [OpenAPI document](https://skmtc.dev/fundraiseup/apis/fundraise-up-api/revisions/99beadff7525?raw)