---
title: "Wipe a phone"
method: POST
path: "/phones/{phone_id}/wipe"
tags: ["phones"]
---

# Wipe a phone

`POST /phones/{phone_id}/wipe`

Requests an on-demand factory reset of a private phone the caller's org owns. Requires the phone to be ACTIVE and not currently allocated. Sets the phone to MAINTENANCE while the wipe is carried out.

## Path parameters

- `phone_id` string, required — device identifier

## Response `200`

OK

- PhoneSuccessResponse — Generic success message response.
  - `$schema` string, uri — A URL to the JSON Schema for this object.
  - `message` string, required — Human-readable success description.

## Other responses

- `default` — Error

## Changes

- **2026-07-01** `e2a192903d23` — 1 info
  - api operation id `devices_wipe` removed and replaced with `phones_wipe`
- **2026-07-01** `f8ffe9f2b8ee` — 2 info
  - api tag `phones` added
  - api tag `devices` removed
- **2026-06-29** `206b42a858c3` — 1 info
  - api operation id `device-wipe` removed and replaced with `devices_wipe`

[Change history](https://skmtc.dev/axilioai/apis/axilio-api/changes/phones/:phone_id/wipe/post.md)

---

[API](https://skmtc.dev/axilioai/apis/axilio-api.md) · [All operations](https://skmtc.dev/axilioai/apis/axilio-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/axilioai/axilio-api/revisions/a0204e0956bc/schema)