Update a maker-checker approver group

PATCH

/maker-checker-approver-groups/{id}

Updates one or more editable attributes on an existing maker-checker approver group for the authenticated entity. Only the fields included in the request body are changed; omitted values keep their current values. The group must belong to the same entity as the bearer token, and the group's entity_id is derived server-side and cannot be supplied by the client. When is_default is set to true, the group becomes the default for its entity and type and any other active default group for the same entity/type is automatically demoted.

Request

Authorization

JWT Bearer

Add the parameter

Authorization

to Headers

Example:

Authorization: ********************

Path Params

Body Params application/jsonRequired

Examples

Responses

🟢200

application/json

The maker-checker approver group was updated successfully and the full updated record is returned.

Bodyapplication/json

🟠400

🟠401

🟠404

🟠409

Request Example

Shell

JavaScript

Java

Swift

cURL

Rename a groupReplace approver listSet this group as the default

curl --location --request PATCH '/maker-checker-approver-groups/01J9K8M6P7Q2W3X4Y5Z6A7B8C9' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "group_name": "Payout Reviewers"
}'

Response Example

200 - Success

{
    "message": "Maker-checker approver group updated successfully",
    "status": "success",
    "data": {
        "id": "01J9K8M6P7Q2W3X4Y5Z6A7B8C9",
        "entity_id": "01J9K8M6P7Q2W3X4Y5Z6A7B8D1",
        "group_name": "Payout Reviewers",
        "type": "payout",
        "status": "active",
        "is_default": true,
        "approvers": [
            {
                "approval_order": 1,
                "identity_id": "01J9K8M6P7Q2W3X4Y5Z6A7B8D2",
                "identity": {
                    "id": "01J9K8M6P7Q2W3X4Y5Z6A7B8D2",
                    "name": "Ada Adebayo",
                    "email": "ada@acmecorp.ng"
                },
                "configuration_meta": {
                    "role": "finance-approver"
                },
                "added_by": "01J9K8M6P7Q2W3X4Y5Z6A7B8E1"
            },
            {
                "approval_order": 2,
                "identity_id": "01J9K8M6P7Q2W3X4Y5Z6A7B8D3",
                "identity": {
                    "id": "01J9K8M6P7Q2W3X4Y5Z6A7B8D3",
                    "name": "Samuel Okafor",
                    "email": "sam@acmecorp.ng"
                },
                "configuration_meta": null,
                "added_by": "01J9K8M6P7Q2W3X4Y5Z6A7B8E1"
            }
        ],
        "created": 1754478720000,
        "updated": 1754478780000
    }
}

Modified at 2026-09-13 11:55:45

Deactivate a maker-checker approver group

Retrieve a maker-checker approver group