Agents

Reassign an agent to a different account

View as Markdown

Moves ownership of the agent to the target accountId in the request body. Caller must currently own the agent, or provide a valid X-Admin-Token to force reassignment.

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

Request

This endpoint expects an object.
accountIdstringRequired
Target account that should own the agent after reassignment

Response

Agent reassigned
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