Detach a default caller ID from an agent

Deprecated

DELETE

https://api.smallest.ai/atoms/v1/agent/:agentId/caller-ids/:sourceId

Removes the source from the agent’s caller-ID list. sourceId is the phone number product ID or outbound trunk ID. Requires an admin-role key.

number is required for every source kind: it names the caller ID to detach. Omitting it is refused with 400 (“Say which caller ID to detach: pass ?number=+E164 (URL-encode the +)”). For a phoneNumber source, pass the number itself.

Removes the source from the agent's caller-ID list. `sourceId` is the phone number product ID or outbound trunk ID. Requires an admin-role key. `number` is required for every source kind: it names the caller ID to detach. Omitting it is refused with `400` ("Say which caller ID to detach: pass ?number=+E164 (URL-encode the +)"). For a `phoneNumber` source, pass the number itself.

Authentication

AuthorizationBearer

API key from the console ApiKey collection, sent as Bearer token. Also accepts session cookies for browser-based auth.

Path parameters

agentIdstringRequired

sourceIdstringRequired

Query parameters

numberstringRequired

The E.164 number of the caller ID to detach. URL-encode the + as %2B (e.g. ?number=%2B14155552671). For a phoneNumber source, pass the number itself.

Response

Source detached

statusbooleanOptional

dataobjectOptional

Errors

404

Not Found Error

1	import requests
2
3	url = "https://api.smallest.ai/atoms/v1/agent/agentId/caller-ids/sourceId"
4
5	querystring = {"number":"number"}
6
7	headers = {"Authorization": "Bearer <token>"}
8
9	response = requests.delete(url, headers=headers, params=querystring)
10
11	print(response.json())