---
title: "Delete multiple designations"
method: POST
path: "/v1/designations/batch/delete"
tags: ["Designations"]
---

# Delete multiple designations

`POST /v1/designations/batch/delete`

Use this request to delete multiple designations at once. Each designation is processed independently. A designation cannot be deleted if it is the default designation of the account or is in use.

## Request body

- BatchDeleteDesignationsRequest — Contains the request parameters for deleting multiple designations.
  - `items` BatchDeleteDesignationItem[], required — An array of designations to delete.
    - `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. Designations only exist in live mode — set this to `true`.

## Response `200`

Returns the result of the batch delete operation, including the status of each designation.

- BatchDeleteDesignationsResponse — The result of a batch delete designations operation.
  - `results` BatchDeleteDesignationResult[], required — An array containing the result for each item in the request, in the same order.
    - `error` BatchDeleteDesignationError, required — Error details for a single designation in the batch delete operation.
      - `code` 'designation_not_found' | 'designation_is_default' | 'designation_in_use', 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 delete designations.
- `422` — The request contains duplicated ids.

---

[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)