---
title: "Changes to Promote a mirror ledger"
method: POST
path: "/v3/{ledgerName}/promote"
---

# Changes to Promote a mirror ledger

`POST /v3/{ledgerName}/promote`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 9 of 119 revisions.

- **2026-11-03** `f5e817eca038`: 1 info
- **2026-10-09** `45c54ddbb457`: 7 warning, 9 info
- **2026-10-08** `3da23d327316`: 3 info
- **2026-09-30** `b747efd5cd77`: 1 info
- **2026-09-29** `6ff73ac9a6bd`: 1 breaking
- **2026-09-15** `4d9a40e2c939`: 1 info
- **2026-09-01** `4d28c76b4328`: 1 info
- **2026-08-28** `fe945da1b75d`: 1 breaking
- **2026-07-20** `cf34a2749985`: 1 info

## Changes

- **2026-11-03** `f5e817eca038`: 1 info
  - api operation id `promoteLedger` removed and replaced with `v3PromoteLedger`
- **2026-10-09** `45c54ddbb457`: 7 warning, 9 info
  - removed the optional property `data/account_types` from the response with the `201` status
  - removed the optional property `data/created_at` from the response with the `201` status
  - removed the optional property `data/default_enforcement_mode` from the response with the `201` status
  - removed the optional property `data/deleted_at` from the response with the `201` status
  - removed the optional property `data/metadata_schema` from the response with the `201` status
  - removed the optional property `data/mirror_source` from the response with the `201` status
  - removed the optional property `data/mirror_sync_progress` from the response with the `201` status
  - added the optional property `data/accountTypes` to the response with the `201` status
  - added the optional property `data/createdAt` to the response with the `201` status
  - added the optional property `data/deletedAt` to the response with the `201` status
  - added the optional property `data/metadata` to the response with the `201` status
  - added the optional property `data/metadataSchema` to the response with the `201` status
  - added the optional property `data/mirrorSource` to the response with the `201` status
  - added the optional property `data/mirrorSyncProgress` to the response with the `201` status
  - the response property `data/mode` became required for the status `201`
  - added the required property `data/defaultEnforcementMode` to the response with the `201` status
- **2026-10-08** `3da23d327316`: 3 info
  - added the media type `text/plain` for the response with the status `401`
  - added the media type `text/plain` for the response with the status `403`
  - added the non-success response with the status `429`
- **2026-09-30** `b747efd5cd77`: 1 info
  - endpoint added
- **2026-09-29** `6ff73ac9a6bd`: 1 breaking
  - api path removed without deprecation
- **2026-09-15** `4d9a40e2c939`: 1 info
  - added the non-success response with the status `409`
- **2026-09-01** `4d28c76b4328`: 1 info
  - endpoint added
- **2026-08-28** `fe945da1b75d`: 1 breaking
  - api path removed without deprecation
- **2026-07-20** `cf34a2749985`: 1 info
  - endpoint added

---

[Operation](https://skmtc.dev/formancehq/apis/ledger-api/docs/v3/:ledgerName/promote/post.md) - [API](https://skmtc.dev/formancehq/apis/ledger-api.md) - [Page](https://skmtc.dev/formancehq/apis/ledger-api/changes/v3/:ledgerName/promote/post)