All commands · internal
pm item mutate
Apply SDK-backed mutations atomically.
Apply SDK-backed mutations atomically.
Usage
pm item mutate [options]Options
| --transaction-id <value> | Stable idempotency key used to resume an interrupted batch; derived from the document when omitted | optional |
|---|---|---|
| --stdin-json | Read the JSON mutation array from stdin | optional |
| --from <path> | Read the JSON, JSON Lines, or envelope document from a file (- for stdin) | optional |
| --upsert-key <field> | Update the existing item whose field matches instead of creating a duplicate | optional |
| --dry-run | Validate and preview the batch without writing | optional |
| --create-compensation <mode> | Created-item compensation policy: close or delete | optional |
| --lock-ttl-seconds <n> | Workspace transaction lock lifetime in seconds | optional |
| --lock-wait-ms <n> | Maximum time to wait for the workspace transaction lock | optional |
| --author <value> | Mutation author | optional |
Examples
pm item mutate --help