Get Bulk Decision Impact
POST/api/cost-changes/bulk-decision-impact
Returns the decision-impact preview for a selection: one block per set (the same shape as Get Decision Impact, in oldest-first order) plus totals across them - how many sets are allowed to proceed, how many ledger entries are touched and their total amount, the provider-side voids and updates, the period batches that would be re-sent, and how many writes a locked period displaces. Use it to confirm a bulk switch or revert with the whole picture in view.
inventory:writeGrant this scope to your token under Settings → Developer → Personal Access Tokens.
Authentication: Requires Bearer token (inventory scope) and permission to resolve cost changes.
Body fields:
- ids (required, array of integers, min 1): cost change set IDs
- to (required): restate, prospective or revert
Request
Responses
- 200
- 401
- 403
- 422
- 429
OK
Response Headers
Unauthenticated — the bearer token is missing, revoked, expired, or malformed. Never retry automatically; fix the credential. See the Errors guide.
Forbidden — the token lacks a required scope, the endpoint is not available to API tokens, or the user behind the token lacks the permission. A human must adjust the token scopes or user permissions; do not retry.
Unprocessable Content
Response Headers
Rate limited — platform limit is 1,000 requests/min; individual tokens may carry lower limits. Honor the Retry-After header before retrying. See the Rate Limits guide.