NetBird
voice_numbers_update
Change what happens to calls arriving for one number, or the workspace's own label for it. Set the route to `reject` to stop it answering, to `trunk` with a trunk_id to deliver to one of your SIP trunks, or to `forward` with a forward_to and a forward_as to place a call to one of your verified caller IDs. The route replaces whatever was set before, because a number has exactly one answer at a time, and forward_as has no default so state it on every forward. Only a number whose calls arrive at Bird can carry a route.
Remote bird/mcp
Remote (network-hosted)
Other tools also called voice_numbers_update?
See providers with this name
Input Schema
{
"type": "object",
"properties": {
"name": {
"type": [
"null",
"string"
],
"description": "Your own label for this number. Send null to remove the one it has. Omit to leave it unchanged."
},
"route": {
"type": "string",
"examples": [
"reject",
"trunk",
"forward"
],
"description": "What a call arriving for this number should do. reject refuses it and is where every number starts. trunk delivers it to one of your SIP trunks and needs trunk_id. forward places a call to one of your verified caller IDs and needs forward_to and forward_as. The route replaces whatever was set before, because a number has exactly one answer at a time. Omit to leave the answer unchanged."
},
"trunk_id": {
"type": [
"null",
"string"
],
"description": "For route trunk: the SIP trunk that answers calls to this number (spt_ prefix). It must be yours and must have inbound calling enabled — voice_trunks_update is what enables it."
},
"number_id": {
"type": "string",
"description": "Voice number ID (vnu_ prefix), from voice_numbers_list."
},
"forward_as": {
"type": [
"null",
"string"
],
"examples": [
"dialed_number",
"calling_number"
],
"description": "For route forward: which of the forwarded call's two numbers it shows as the caller. dialed_number needs your workspace approved to call from numbers bought from us; calling_number rings as though the caller dialled directly but some carriers screen it. There is no default, so state it on every forward."
},
"forward_to": {
"type": [
"null",
"string"
],
"description": "For route forward: the number calls are forwarded to, in E.164. It has to be one of your verified caller IDs, checked on write and again on every forwarded call."
},
"idempotency_key": {
"type": "string",
"description": "Client-supplied deduplication key; a retry with the same key replays the original result instead of acting twice."
}
}
}