---
title: "Change SIM state"
method: POST
path: "/devices/{deviceId}/state"
tags: ["SIMs (Devices)"]
---

# Change SIM state

`POST /devices/{deviceId}/state`

## Request

- Base URL: `https://dashboard.hologram.io/api/1`
- URL: `https://dashboard.hologram.io/api/1/devices/{deviceId}/state`
- Auth: HTTP basic
- TypeScript: <https://skmtc.dev/hologram/apis/hologram-rest-api-v1/docs/devices/:deviceId/state/post.ts> (a function with typed inputs; its response is checked against the schema)

Change the state of a SIM in a device. Supported state values are `pause`, `live`, and `deactivate`.

Pausing the SIM will prevent your device from passing any data on all profiles installed on the SIM. Paused SIMs still incur Monthly Recurring Charges.

Deactivating permanently removes the SIM card from service. Deactivation is supported from any non-deactivated state, including SIMs in Test Mode (network states of `TEST-ACTIVATE`, `TEST-HIBERNATE`, `TEST-AUTOACTIVATE`, and their `-PENDING` variants).

## Path parameters

- `deviceId` integer, required

## Request body

- object
  - `state` 'pause' | 'live' | 'deactivate', required: New state to set. Valid values are `pause`, `live`, or `deactivate`.

## Response `200`

OK

- SimpleSuccessResponse
  - `success` boolean: Indicates whether the request was successful.

## Other responses

- `400`: Bad request
- `401`: Unauthorized

---

[API](https://skmtc.dev/hologram/apis/hologram-rest-api-v1.md) - [All operations](https://skmtc.dev/hologram/apis/hologram-rest-api-v1/llms.txt) - [OpenAPI document](https://skmtc.dev/hologram/apis/hologram-rest-api-v1/revisions/1bc07dcd1631?raw)