Backfill Provider Cache
POST/api/ledger/reconciliation/backfill
Populate the local provider document cache (the xero_/qbo_ mirror) for a connection by dispatching a tracked background job that downloads every remote document over the reconcile window. The reconcile screen, matching, and the period-comparison report all read off this local cache, so this is the on-demand, UI-triggered equivalent of the ledger:cache:backfill artisan command. Returns the tracked job log id so the frontend can follow progress via the tracked job log endpoints.
This endpoint currently requires session authentication; Personal Access Token scope support is in progress.
Authentication: Requires Bearer token + accounting.sync permission.
from/to (Y-m-d) are optional and default to the connection's reconcile window (the connection's sync start date through today).
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.
Validation failed — the body is a field → messages map (Laravel shape) or the platform envelope with a stable machine-readable code. Fix the payload and resubmit.
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.