Remove from agent

remove the agent from a phone number.

DELETE https://api.centerfy.ai/webhooks/inbound/phone-numbers/:id/agent

Headers

Header	Required	Value	Description
`x-api-key`	Yes	your sub-account API key (cfy_…)	Your API key. Alternatively, pass it as Authorization: Bearer `<key>`.

Path parameters

Name	Type	Required	Description
`id`	`string (uuid)`	Yes	The phone number id to unassign.

Example

curl -X DELETE "https://api.centerfy.ai/webhooks/inbound/phone-numbers/{id}/agent" \
  -H "x-api-key: $CENTERFY_API_KEY"

import { CenterfyClient } from "@centerfy/sdk";

const centerfy = new CenterfyClient({ apiKey: process.env.CENTERFY_API_KEY! });

const result = await centerfy.phoneNumbers.unassignAgent("<phoneNumberId>");
console.log(result);

centerfy phoneNumbers unassign-agent <phoneNumberId>

MCP tool: centerfy_phone_numbers_unassign_agent (see MCP server)

Response

{
  "status": "success",
  "unassigned": true,
  "phone_number_id": "3f1c2b9a-7d4e-4a21-9c33-0a1b2c3d4e5f",
  "phone_number": "+14155552671",
  "agent_id": null
}

Errors

400 — if the id is not a valid UUID; 404 if no such phone number exists.

Notes

Removes the agent so the number no longer routes inbound calls, while keeping the number active and immediately reassignable. Releasing the number itself is a separate operation. Idempotent: a number that has no agent succeeds with already_unassigned: true.