Queues a physical actuation command for one dock and returns immediately with a command resource to poll. Use this to open or close a dock; do not call it in a tight retry loop on transient failures without a fresh Idempotency-Key decision — reuse the SAME key for a genuine retry of the identical request, and mint a new key for a deliberately different command. The dock must not already have another command in flight, or this returns 409 dock_busy. Name approved and reserved 2026-08-03 (see contracts/README.md decision #1); a full reference implementation exists in the sandbox server (see x-sandbox at the document root) — the production route (viam task 3.6) is not yet built.
Reserved — this name is approved and frozen, but the production route is not yet built. A full reference implementation exists in the sandbox — see theserversentry andx-sandboxextension in the spec.
POST /api/v1/docks/{dockId}/commandssessionfalsetruetrue202 — Command queued.400 — command missing or not one of the closed enum values, or Idempotency-Key missing.401 — Not signed in.403 — Demo mode is read-only, or the caller lacks entitlement on this dock.404 — No such dock.409 — The dock already has a command in flight, or Idempotency-Key was reused with a different request body.429 — Too many requests from this IP.503 — The command channel is fail-closed unavailable.