Update Accounting Dimensions

PUT 
/api/ledger/accounting-dimensions

Save the per-channel slot configuration. Up to two dimension slots are allowed; each slot must reference a distinct provider dimension (a 422 is returned otherwise).

Authentication: Requires Bearer token.

Slot fields:

• slot — 1 or 2
• provider_dimension.type — xero_tracking_category or qbo_class
• provider_dimension.mirror_id — the local id of the chosen dimension
• driver — sales_channel
• apply_to — object with revenue, cogs, fba booleans (which document families are tagged)
• default_value_mirror_id — fallback value id applied to unmapped channels (null to leave them untagged)
• mappings[] — one row per channel: channel_instance_id (null for the internal pseudo-channel), value_mirror_id, and optional sub_channel_overrides keyed by sub-channel id

Returns the saved configuration with recomputed warnings.

Request

Responses

200

OK

Response Headers

Content-Type

401

Unauthenticated — the bearer token is missing, revoked, expired, or malformed. Never retry automatically; fix the credential. See the Errors guide.

403

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.

422

Unprocessable Entity

Response Headers

Content-Type

429

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.