---
title: "Changes to Update the mode of a merchant (live/sandbox)"
method: PATCH
path: "/api/v1/merchants/{id}/mode"
---

# Changes to Update the mode of a merchant (live/sandbox)

`PATCH /api/v1/merchants/{id}/mode`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 3 of 8 revisions.

- **2026-06-16** `b372e7d5563d` — 1 breaking, 1 warning, 6 info
- **2025-11-03** `6637b341d86d` — 1 info
- **2025-11-02** `919eb7a392aa` — 1 breaking

## Changes

- **2026-06-16** `b372e7d5563d` — 1 breaking, 1 warning, 6 info
  - the `error/code` response's property type/format changed from `string`/`` to ``/`` for status `400`
  - removed the optional property `error/errors` from the response with the `400` status
  - added the optional property `data/country` to the response with the `200` status
  - added the optional property `data/settlement_currency` to the response with the `200` status
  - added the optional property `error/metadata` to the response with the `400` status
  - added `subschema #1, subschema #2` to the `error/code` response property `allOf` list for the response status `400`
  - added the required property `data/has_client_secret` to the response with the `200` status
  - added the required property `data/refund_retention_rate` to the response with the `200` status
- **2025-11-03** `6637b341d86d` — 1 info
  - endpoint added
- **2025-11-02** `919eb7a392aa` — 1 breaking
  - api path removed without deprecation

---

[Operation](https://skmtc.dev/banqzinc/apis/quidkey-api/docs/api/v1/merchants/:id/mode/patch.md) · [API](https://skmtc.dev/banqzinc/apis/quidkey-api.md) · [Page](https://skmtc.dev/banqzinc/apis/quidkey-api/changes/api/v1/merchants/:id/mode/patch)