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

# Policy updates

> Test policy updates in the Sandbox environment.

You can run the whole flow against `https://sandbox.axle.insure`, including from the **Try it** panel on [Request Policy Update](https://docs.axle.insure/api-reference/policies/request-policy-update.md). Sandbox checks your request the same way production does, then simulates the insurance carrier instead of contacting one.

1. Start an Ignition session in sandbox and complete Policy Lookup with the [sandbox test inputs](https://docs.axle.insure/guides/sandbox/ignition-completion.md#test-credentials-for-policy-lookup). Pick an insurance carrier and policy type that support the operation; see [Operations](https://docs.axle.insure/guides/policy-updates.md#operations).
2. Exchange the `authCode` for an `accessToken` and note the policy's `id`. See the [Quickstart](https://docs.axle.insure/guides/quickstart.md) for that step.
3. Send `POST /policies/{policyId}/updates` with your sandbox `x-client-id` and `x-client-secret`. In **Try it**, choose the sandbox server.

About 10 seconds later you'll receive `policy-update.request-succeeded`. When `processesInstantly` is `true`, `policy-update.policy-refresh-succeeded` follows about 5 seconds after that, and the policy now lists the lienholder from your policy update configuration as primary. Sandbox always succeeds, so it never sends the `failed` events. Until those events arrive, another request on the same policy returns `409` with `policy-update-in-progress`.

> [!NOTE]
>
> Sandbox requires and reports [input](https://docs.axle.insure/guides/policy-updates/request.md#input) fields the same way each insurance carrier does in production. Accepted values are recorded on the policy update, but the simulated update doesn't apply them to the policy.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.