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

# Refresh a SIM's network connection

> Perform a **network refresh**, issuing an update location request, to end a SIM's current data session and have it reconnect to the first available network. Use it when you can't physically reboot a device. If the SIM is connected, the refresh should close the current session and reconnect. If the SIM isn't connected, the refresh happens the next time the SIM tries to connect to a network.

<Note>
  **Note:** Hologram recommends rebooting your device instead of using a network refresh if your device is physically accessible.
</Note>

## Which SIMs can perform a network refresh?

SIMs that meet both of these conditions can be refreshed:

* The SIM is in the **Ready** or **In testing** status (`LIVE` or `TEST-ACTIVATE` network state).
* The carrier for the SIM's enabled profile supports update location. G2 and US2 profiles, for example, don't support update location requests.

## How to refresh a single SIM

1. Open a SIM from the SIMs pages or using global search.
2. Click the **Manage SIM** menu at the top of the page and choose **Network refresh...**.
3. Review the details, then click **Submit network refresh**.

## How to refresh SIMs in bulk

1. Navigate to the **SIMs** section in your dashboard and open the **Active SIMs** page.
2. Use filters to find and select up to 10 SIMs you want to refresh.
3. Click the **Manage SIMs** menu at the top of the list and choose **Network refresh...**.

## How to perform a network refresh using the REST API

<Card title="REST API endpoint" href="/api/1/links/cellular/updatelocation/post">
  Update location / Network refresh <code>POST /links/cellular/updatelocation</code>
</Card>

The REST API works differently from the dashboard:

* You pass profile (cellular link) IDs, up to 10 per request.
* If any profile in the request fails a check, the whole request is rejected and none of the profiles are refreshed.
* Add `?preview=1` to run every check without sending the refresh. This lets you confirm a selection is eligible first.

## Related actions

<Card title="Pause or resume SIMs" href="/dashboard/sim-actions/pause-resume-sims">
  Pause or resume data usage for your SIMs
</Card>

<Card title="Switch profiles" href="/dashboard/sim-actions/switch-profiles">
  Switch a SIM with Outage Protection™ to a different profile
</Card>