kf reservation
Manage reservations on the inventory hot path.
Idempotent reservation lifecycle commands. Replays return the original receipt; explicit expire is for manual cleanup.
kf reservation commit
Commit a reservation through the GraphQL command surface.
Idempotent via --idempotency-key.
| Flag | Required | Description |
|---|---|---|
--tenant <id> | yes | Target tenant id. |
--reservation-id <id> | yes | Reservation id. |
--expected-version <n> | yes | Optimistic concurrency token. |
--actor-type <type> | yes | Actor type. |
--actor-id <id> | yes | Actor id. |
--reason <code> | no | Domain reason code. |
--idempotency-key <key> | no | Idempotency key for safe retries. |
Example
kf reservation commit --tenant tnt_demo --reservation-id rsv_01 --expected-version 1 --actor-type USER --actor-id usr_samkf reservation expire
Force-expire an ACTIVE reservation past its expiresOn.
Normally driven by the expire-sweeper worker; exposed for explicit cleanup workflows.
| Flag | Required | Description |
|---|---|---|
--tenant <id> | yes | Target tenant id. |
--reservation-id <id> | yes | Reservation id. |
--expected-version <n> | yes | Optimistic concurrency token. |
--actor-type <type> | yes | Actor type. |
--actor-id <id> | yes | Actor id. |
--idempotency-key <key> | no | Idempotency key for safe retries. |
Example
kf reservation expire --tenant tnt_demo --reservation-id rsv_01 --expected-version 3 --actor-type USER --actor-id usr_sam