---
title: Update a mandate
description: Modify the details of an existing DebiPay mandate through the update endpoint.
openapi: /openapi/debi-pay-api.yaml PUT /api/v1/mandates
---

> **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 update the details of an existing mandate. The request body allows you to change the mandate's commercial and payment details while preserving the mandate identity and linking it to the same payer.

<Info>
Use the update operation when you need to revise a mandate after it has already been created, such as changing the payer, amount, payment method, or address details.
</Info>

## Fields you may update

The request payload supports fields such as:

- `id` to identify the target mandate
- `address` for postal or physical address details
- `amount`, `startDate`, and `actionDayId` for payment timing
- `bankAccount`, `bankCard`, or `paymentMethodId` for payment method changes
- `payer` and signatory names for customer details

## When to use it

- Correct information after initial mandate creation.
- Adjust the payment method or amount for the mandate.
- Refresh customer or signatory details without recreating the mandate.

<Tip>
If the change is temporary or you want to pause processing, the suspend endpoint may be more appropriate than a full update.
</Tip>

## Related pages

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


---

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