vobiz-phone-numbers
Installation
SKILL.md
Vobiz Phone Numbers skill
Use this when the user wants to buy a new phone number, attach it to a trunk, hand it to a sub-account, or release it.
Base URL: https://api.vobiz.ai/api/v1. Auth: X-Auth-ID + X-Auth-Token on every request.
Endpoints
| Op | Method + Path | Notes |
|---|---|---|
| Search inventory | GET /Account/{auth_id}/inventory/numbers |
Filter by country, search (substring on E.164), page, per_page (max 100) |
| Purchase | POST /Account/{auth_id}/numbers/purchase-from-inventory |
Body: { "e164": "+91...", "currency": "INR" }. Debits setup_fee + monthly_fee |
| List owned | GET /Account/{auth_id}/numbers |
Returns items (status, fees, application_id, trunk_group_id). include_subaccounts defaults true for MA_ |
| Assign to trunk | POST /Account/{auth_id}/numbers/{phone_number}/assign |
Body: { "trunk_group_id": "<uuid>" }. Path number must be %2B-encoded |
| Unassign from trunk | DELETE /Account/{auth_id}/numbers/{phone_number}/assign |
Path number must be %2B-encoded |
| Assign to sub-account | POST /account/{auth_id}/numbers/{e164}/assign-subaccount |
lowercase account, %2B-encoded. Body: { "sub_account_id": "SA_..." } |
| Unassign from sub-account | DELETE /account/{auth_id}/numbers/{e164}/assign-subaccount |
lowercase account. 15-day cool-off; admin ?force=true |
| Release (unrent) | DELETE /Account/{auth_id}/numbers/{e164} |
Permanent — returns to inventory |