---
title: Upload mandate cancellations
description: Upload a file containing mandate cancellations for batch processing through DebiPay.
openapi: /openapi/debi-pay-api.yaml PUT /api/v1/mandates/upload-cancellations
---

> **For AI agents:** the complete documentation index is at [llms.txt](/llms.txt). Append `.md` to any page URL for its markdown version.

Use this endpoint to upload a file that contains cancellation instructions for one or more mandates. It is intended for bulk cancellation workflows where you want to submit many termination requests in a single file.

<Info>
This operation is useful for back-office or partner integrations that already manage mandate cancellations in a file-based import process.
</Info>

## Typical use cases

- Batch-cancel mandates for a merchant or cohort.
- Process a file exported from another internal system.
- Perform large-scale mandate cleanup without submitting each cancellation individually.

## Request details

The request uses a multipart form upload with a file field named `File`. The generated request schema in the right panel shows the supported format for your deployment.

## Response handling

The API returns a confirmation that the cancellation file was accepted and the batch process was triggered. Follow up with the relevant mandate operations to confirm the resulting state of each mandate.

<Tip>
Use this endpoint when your cancellation workflow is already file-driven; it is more efficient than sending one cancellation request per mandate.
</Tip>

## Related pages

- [Cancel a mandate](./mandate-cancel)
- [Upload mandates](./mandates-upload)
- [Get mandates](./mandates-get)


---

📦 **OpenAPI specs:** Every OpenAPI specification referenced by this documentation is available as a single download — https://mutex-core-apis.jamdesk.app/api-specs.zip