Designations

Delete multiple designations

Changed on

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.

post/v1/designations/batch/delete

Request

  • Base URL
    https://api.fundraiseup.com (the document declares no server; this is the origin it was published from)
  • Auth
    HTTP bearer

Request body

livemodeboolean

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.

Example request

{
  "items": [
    {
      "id": "EXXXXXXX"
    }
  ],
  "livemode": true
}

Response

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

status'complete' | 'partial' | 'failed' required

Status of the bulk operation.

Example response

{
  "results": [
    {
      "error": {
        "code": "designation_not_found",
        "message": "Designation not found."
      },
      "id": "EXXXXXXX"
    }
  ],
  "status": "complete"
}

Changes