> ## Documentation Index
> Fetch the complete documentation index at: https://docs.pylva.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Sync budget accumulators

> Reconcile SDK-side budget accumulators against backend-authoritative totals so budget hard stops stay consistent across replicas.

The SDK uses this endpoint to reconcile local budget accumulators with backend totals. Most teams should not call it directly.

## Request

```json theme={null}
{
  "entries": [
    {
      "rule_id": "00000000-0000-0000-0000-000000000000",
      "scope": "per_customer",
      "customer_id": "cust_abc123",
      "accumulated_cost_usd": 42.5,
      "period_start": "2026-06-01T00:00:00.000Z",
      "event_count": 18
    }
  ]
}
```

## Response

```json theme={null}
{
  "entries": [
    {
      "rule_id": "00000000-0000-0000-0000-000000000000",
      "customer_id": "cust_abc123",
      "authoritative_cost_usd": 43.1,
      "period_start": "2026-06-01T00:00:00.000Z"
    }
  ]
}
```

## Notes

* Backend totals are authoritative.
* The SDK overwrites local accumulators from the response.
* This endpoint is part of budget hard-stop safety across multiple SDK replicas.
