Mandates APIbetaMandate management
Create amendment request
Create amendment request while mandate is ACTIVE or SUSPENDED.
At least one of validity or payTo must be provided. The payTo field is only allowed for PayTo mandates.
If the mandate has already been used for payments, the validity.from (start date) cannot be amended.
Authorization
Bearer AuthorizationBearer <token>
Bearer token using a JWT.
In: header
Path Parameters
id*string
Identifier of the mandate.
Format
uuidHeader Parameters
X-Volt-Api-Version*1
Version of the API used. Currently, version 1 is the only version.
Value in
- 1
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
PayTo mandate amendment request body.
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/mandates/497f6eca-6276-4993-bfeb-53cbbbba6f08/amendments" \ -H "X-Volt-Api-Version: 1" \ -H "Content-Type: application/json" \ -d '{ "validity": { "to": "2026-08-31 00:00:00" }, "payTo": { "limits": { "payment": { "amount": 12000 } } } }'{ "id": "79fb2306-e199-497e-b5a1-912a68a02894", "mandateId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890", "track": "BILATERAL", "initiator": "CUSTOMER", "status": { "status": "AWAITING_APPROVAL", "details": null }, "changes": { "validity": { "to": "2026-08-31 00:00:00" }, "payTo": { "limits": { "payment": { "amount": 12000 } } } }, "createdAt": "2026-04-10T12:00:34+00:00", "updatedAt": "2026-04-10T12:00:34+00:00"}{ "code": "BAD_REQUEST", "message": "string"}{ "code": "UNAUTHORISED", "message": "string"}{ "code": "ACCESS_DENIED", "message": "string"}{ "code": "RESOURCE_NOT_FOUND", "message": "string"}{ "code": "CONFLICT", "message": "string"}{ "code": "VALIDATION_FAILURE", "message": "string", "errors": [ { "type": "string", "propertyPath": "string", "message": "string" } ]}{ "code": "INTERNAL_SERVER_ERROR", "message": "string"}