---
title: "Promote Desired State"
method: POST
path: "/fleet/desired-state/promote"
---

# Promote Desired State

`POST /fleet/desired-state/promote`

## Request

- Base URL: `https://api-docs.session-exchange.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api-docs.session-exchange.com/fleet/desired-state/promote`
- Auth: none declared

## Request body

- PromoteRequest: Promote a candidate desired-state version to `active`. `version` must be the current candidate. `ack` is a reserved extension point for a future dry-run-ack gate (unused in v0.1).
  - `version` integer, required
  - `ack` boolean

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/session-exchange/apis/a4sx.md) · [All operations](https://skmtc.dev/session-exchange/apis/a4sx/llms.txt) · [OpenAPI document](https://skmtc.dev/session-exchange/apis/a4sx/revisions/abaefc33dfc7?raw)