The phone number is moved from its current owner to a new agent, provided the new agent has no active number.
Retrieve the list of numbers to identify the target number ID. Check that the target agent does not already have an active number, as the system requires the target to be free. Send a PATCH request to the /v1/numbers/{number_id}/reassign endpoint with the new agent_id. Verify the reassignment was successful.
- Category: Operations and infrastructure
- Effect: Changes data in your accounts
- MCP servers: AgentLine MCP (https://koskamo.com/explore/agentline-mcp)
- Source: Phone Numbers - AgentLine (https://docs.agentline.cloud/guides/numbers)
- Source quote: "Reassigning moves the number to another agent. The target agent must not already have an active number."
- Playbook page: https://koskamo.com/explore/use-cases/reassign-a-phone-number-to-a-different-agent
Prompt: Reassign phone number 'num_abc' to agent 'agent_456'.