Save Earmarked Inventory Accounts
PUT/api/ledger/reconciliation/inventory/accounts
Replace the earmarked inventory control account set and return the refreshed candidate list. The submitted set replaces existing earmarks wholesale — an empty array clears them. The earmarked accounts are what the daily series and rebuild job operate on.
Any valid API token can call this endpoint — no specific scope required. Manage tokens.
Authentication: Requires Bearer token + accounting.sync permission.
Request body:
nominal_code_ids(array, required/present — may be empty): nominal code ids to earmark. Each must exist innominal_codes.
Returns the same payload shape as GET .../inventory/accounts with is_earmarked reflecting the new set.
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.