---
title: "Add Desired State Candidate"
method: POST
path: "/fleet/desired-state"
---

# Add Desired State Candidate

`POST /fleet/desired-state`

## 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`
- Auth: none declared

## Request body

- DesiredStateCandidateRequest: A new fleet desired-state version (specs/fleet-desired-state/v0.1). The whole `FleetDesiredState` manifest is POSTed as a parsed dict (loose by design so the manifest schema can evolve without a model migration — the promotion gate validates structure); `raw` is the optional original YAML text (for the git mirror/backup).
  - `manifest` object, required
  - `raw` string, nullable
  - `note` string

## 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)