---
title: Suspend a mandate
description: Pause an active DebiPay mandate for a defined period using the suspend operation.
openapi: /openapi/debi-pay-api.yaml PUT /api/v1/mandates/suspend
---

> **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 temporarily suspend a mandate instead of cancelling it outright. The request body supports the mandate identifier, an optional suspension reason, and a duration in months.

<Info>
Choose the suspend operation when you need a temporary pause rather than a permanent removal of the mandate.
</Info>

## When to use it

- Pause a mandate during a temporary customer issue.
- Stop processing for a defined period while preserving the mandate record.
- Prepare for a later reactivation without recreating the mandate.

## Request details

The request body includes the `mandateId` and may include `suspensionReason` and `suspensionDurationInMonths`. Review the generated request schema for the full accepted fields.

## Response handling

The API returns a confirmation that the suspension request was accepted. Use the generated response model to inspect the resulting status and any supplemental details returned by your deployment.

<Tip>
If the pause should be permanent, use the cancel endpoint instead of suspend.
</Tip>

## Related pages

- [Cancel a mandate](./mandate-cancel)
- [Update a mandate](./mandates-update)
- [Get a mandate by id](./mandates-get-id)


---

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