Unassign/delete agent ownership from an account | Message Blue

Removes the agent→account ownership mapping so the agent can later be assigned to the same or a different account. Caller must own the agent, or provide a valid X-Admin-Token.

Authentication

X-App-Idstring

Your MessageBlue App ID, sent in clear on every request. It is paired with request signing: each request is also signed with your App Secret (see the Authentication tag). The App Secret itself is NEVER transmitted — it is only the HMAC signing key.

Path parameters

phoneNumberstringRequired

Response

Agent unassigned

okboolean

dataobject

Endpoint-specific payload wrapped in a standard success envelope.

metaobject

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

500

Internal Server Error

$	curl -X DELETE https://api.messageblue.ai/agents/%2B14155550123/assign \
>	-H "X-App-Id: <apiKey>" \
>	-H "Content-Type: application/json" \
>	-d '{}'

1	{
2	"ok": true,
3	"data": {
4	"phoneNumber": "+14155550123",
5	"unassigned": true,
6	"previousAccountId": "acc_9f8b7c6d5e4a3b2c"
7	},
8	"meta": {
9	"requestId": "d4f1e2a3-b456-7890-cdef-123456789abc",
10	"timestamp": "2026-07-10T06:00:00.000Z"
11	}
12	}