---
title: "Release a phone"
method: POST
path: "/phones/deallocate"
tags: ["phones"]
---

# Release a phone

`POST /phones/deallocate`

Deallocates a phone the caller's org currently holds. The session is billed and the phone is torn down asynchronously.

## Query parameters

- `phone_id` string, required — device identifier to deallocate

## Response `200`

OK

- PhoneDeallocateResponse — Returned after a device has been successfully deallocated.
  - `$schema` string, uri — A URL to the JSON Schema for this object.
  - `deallocated_at` string, date-time — Timestamp when the device was released.
  - `phone_id` string, required — Released device's identifier.
  - `session_id` string, required — Session that was closed.
  - `workflow_id` string, required — Workflow that was deallocated.

## Other responses

- `default` — Error

---

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