---
title: "Disconnect Recipient"
method: POST
path: "/api/v1/imessage/disconnect"
tags: ["iMessage"]
---

# Disconnect Recipient

`POST /api/v1/imessage/disconnect`

## Headers

- `Idempotency-Key` string, required

## Request body

- DisconnectIMessageRequest
  - `agent_identity_id` string, uuid, required
  - `recipient_number` string, required — Phone number in E.164 format (e.g. '+15551234567').

## Response `200`

Successful Response

- DisconnectIMessageResponse
  - `assignment_id` string, uuid, nullable
  - `disconnected` boolean

## Other responses

- `422` — Validation Error
- `4XX` — Client error with Support Agent information.
- `5XX` — Server error with Support Agent information.

## Changes

- **2026-10-04** `5cbaa42f14f7` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/inkbox/apis/inkbox-api/changes/api/v1/imessage/disconnect/post.md)

---

[API](https://skmtc.dev/inkbox/apis/inkbox-api.md) · [All operations](https://skmtc.dev/inkbox/apis/inkbox-api/llms.txt) · [OpenAPI document](https://skmtc.dev/inkbox/apis/inkbox-api/revisions/5cbaa42f14f7?raw)