<!-- Extension API v0 — pre-1.0. Interfaces may change without notice until P2 seals the custom-code format. First-party extensions track HEAD. -->

# `commands.run`

Run one command envelope {command, storeId, payload, idempotencyKey|dryRun}.

- **method + path**: `POST /v1/commands`
- **TR label**: Komut çalıştırma
- **auth**: public · scope gates: none (public)
- **agentPolicy**: `propose` — a live mutation — an Ajan token's call is recorded into its open proposal (202 `proposed: true`); a Geliştirici token executes it directly.
- **effects**: `db`, `kv`
- **idempotency**: client — `idempotencyKey` in the body is honoured across retries
- **wraps**: — (no command inside)

Machine-readable body schema: [/schemas/routes/commands.run.json](/schemas/routes/commands.run.json).

## Body

No request body.