Skip to main content
POST
Detach Numbers from Agent

Overview

Removes the agent from the given phone numbers. Only numbers currently attached to this agent are affected; any others in the list are skipped and not counted. Detached numbers have no inbound assignment until you attach them somewhere else. The reverse operation is Attach Numbers to Agent. Requires an admin, owner, operator, or prompter role.

Headers

string
required
Your API key for authentication.

Path Parameters

string
required
The agent’s unique identifier.

Body Parameters

string[]
required
Phone numbers to detach, each exactly as it appears on your account (for example +18005551234). Must be a non-empty array of non-empty strings; surrounding whitespace is trimmed. Returns 400 INVALID_BODY otherwise.

Response

string
The agent ID from the request path.
integer
How many of the given numbers were attached to this agent and are now detached. 0 when none were, including when the agent has never had numbers attached or the agent ID is unknown. This endpoint does not return 404 for an unknown agent.
null | array
null on success, or a list of error objects if the request failed.

Docs for agents: llms.txt