Post an opening balance to a GL account
Posts an opening balance to a GL account via the canonical opening-balance
journal entry. Used during entity onboarding and migration to seed account
starting balances. Requires accounting:write scope. Idempotent via the
Idempotency-Key header. The GL postability guard + balance assertion run
on the resulting journal entry.
Authorizations
API key issued per entity via Settings > Developers > API Keys.
Each key carries scopes (e.g. orders:read, products:write).
Bearer token format: Authorization: Bearer ark_live_ent_Test keys use ark_test_ent_. Both are issued per entity
via Settings > Developers > API Keys.
Headers
Client-generated unique key for idempotent POST/PATCH/DELETE operations. Max 255 chars. On retry with the same key, the original response is returned without re-executing the operation. Keys expire after 24 hours. Pattern: or --.
255Path Parameters
GL account UUID.
Body
Response
Opening balance posted.
The response is of type object.

