curl -X DELETE https://api.wirebox.sh/api/v1/identities/eva \
-H "Authorization: Bearer $WIREBOX_API_KEY"
from wirebox import Wirebox
with Wirebox() as wirebox:
wirebox.get_identity("eva").delete()
print("Agent identity deleted")
import { Wirebox } from "@wirebox-sh/sdk";
const wirebox = new Wirebox();
const eva = await wirebox.getIdentity("eva");
await eva.delete();
console.log("Agent identity deleted");
wirebox identity delete eva
(Empty response body)
Agent Identities
Delete Agent Identity
Permanently delete an agent identity and release all associated communication resources.
DELETE
/
api
/
v1
/
identities
/
{handle}
curl -X DELETE https://api.wirebox.sh/api/v1/identities/eva \
-H "Authorization: Bearer $WIREBOX_API_KEY"
from wirebox import Wirebox
with Wirebox() as wirebox:
wirebox.get_identity("eva").delete()
print("Agent identity deleted")
import { Wirebox } from "@wirebox-sh/sdk";
const wirebox = new Wirebox();
const eva = await wirebox.getIdentity("eva");
await eva.delete();
console.log("Agent identity deleted");
wirebox identity delete eva
(Empty response body)
Path Parameters
string
required
The agent handle to remove (e.g.
eva).Response
Returns204 No Content on successful deletion.
Deleting an identity removes its mailbox, tunnel, messages, and phone-message
history. If the identity owns a phone number, Wirebox releases the number with
its carrier before completing the deletion. If carrier release or tunnel
termination fails, the identity remains active and the request returns 502 so
you can retry safely.
Errors
| Status | Code | Meaning |
|---|---|---|
| 502 | carrier_release_failed | The linked phone number could not be released. Retry the request safely. |
| 502 | tunnel_termination_failed | The linked tunnel could not be terminated. Retry the request safely. |
| 500 | deletion_rollback_failed | Phone release failed and the tunnel could not be restored. Retry the request safely. |
curl -X DELETE https://api.wirebox.sh/api/v1/identities/eva \
-H "Authorization: Bearer $WIREBOX_API_KEY"
from wirebox import Wirebox
with Wirebox() as wirebox:
wirebox.get_identity("eva").delete()
print("Agent identity deleted")
import { Wirebox } from "@wirebox-sh/sdk";
const wirebox = new Wirebox();
const eva = await wirebox.getIdentity("eva");
await eva.delete();
console.log("Agent identity deleted");
wirebox identity delete eva
(Empty response body)