Hanzo
OpenapiBooks

Sync ingests the caller's OWN org from commerce into BOTH ledgers (live and…

Sync ingests the caller's OWN org from commerce into BOTH ledgers (live and sandbox) and reports how many new vouchers posted to each.

POST /v1/books/sync

Addresshttps://api.hanzo.ai/v1/books/sync
MethodPOST
Operationpost_books_sync
AuthAuthorization: Bearer $HANZO_API_KEY

Sync ingests the caller's OWN org from commerce into BOTH ledgers (live and sandbox) and reports how many new vouchers posted to each. It is idempotent — money that has already been booked posts nothing on a repeat — and it is read-only against commerce: it never mints a deposit, a credit or a payout, only the accounting twin of money that already moved.

Request

The document declares no body for POST /v1/books/sync. The handler is typed in cloud but its shape is not yet emitted, so the fields are not listed here — ask the MCP door's describe for post_books_sync, which answers from the running route.

Response

StatusBodyMeaning
200syncTallyok

200 body — 2 fields.

FieldInTypeAlwaysDescription
livebodyintegerLive is the number of vouchers newly posted to the live ledger.
sandboxbodyintegerSandbox is the number newly posted to the sandbox ledger.

Failure carries the platform error shape — see Errors.

Examples

hanzo books sync

Books API · All Hanzo APIs · Interactive reference

How is this guide?

On this page