{"openapi":"3.1.0","info":{"title":"Twilio Phone Numbers (BYOK) API","version":"0.1.0","description":"Twilio Phone Numbers (BYOK) lets an AI assistant read your own Twilio Phone Numbers data through the Twilio Phone Numbers API with a key you supply (Account SID or API key SID (use a restricted API key, SID starts with SK, rather than the main Auth Token where possible)). Read-only: 11 tools (list_incoming_numbers, list_local_numbers, list_mobile_numbers, list_toll_free_numbers,...\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://byok-twilio-incoming-numbers.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"agent@connectorbay.com","url":"https://connectorbay.com/byok-twilio-incoming-numbers/docs"},"termsOfService":"https://connectorbay.com/byok-twilio-incoming-numbers/terms"},"servers":[{"url":"https://byok-twilio-incoming-numbers.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/byok-twilio-incoming-numbers/docs"},"security":[{"upstreamKey":[]}],"components":{"securitySchemes":{"bearer":{"type":"http","scheme":"bearer","description":"Optional. A Pro API key raises rate limits; no credentials are required."},"upstreamKey":{"type":"apiKey","in":"header","name":"X-Upstream-Key","description":"Your own key for the service this connector wraps (bring your own key). Used for that one call only; never stored, logged or cached."}},"schemas":{"Error":{"type":"object","properties":{"ok":{"const":false},"error":{"type":"object"}}}}},"paths":{"/v1/tools/list_incoming_numbers":{"post":{"operationId":"list_incoming_numbers","summary":"List all phone numbers owned by the account with capabilities, status, origin, trunk, emergency status and bundle. Webho","description":"List all phone numbers owned by the account with capabilities, status, origin, trunk, emergency status and bundle. Webhook URLs are not returned. Use for \"Which Twilio phone numbers do I own and what can they do\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"account_sid":{"description":"The Twilio Account SID: 'AC' followed by 32 hex characters (shown on the Twilio console home page).","maxLength":34,"title":"Account Sid","type":"string"},"phone_number":{"anyOf":[{"maxLength":20,"type":"string"},{"type":"null"}],"default":null,"description":"Only numbers matching this E.164 number (partial numbers allowed, * is a one-digit wildcard).","title":"Phone Number"},"friendly_name":{"anyOf":[{"maxLength":64,"type":"string"},{"type":"null"}],"default":null,"description":"Only numbers with this friendly name.","title":"Friendly Name"},"origin":{"anyOf":[{"enum":["twilio","hosted"],"type":"string"},{"type":"null"}],"default":null,"description":"Only numbers from this origin: twilio or hosted.","title":"Origin"},"page_size":{"anyOf":[{"maximum":1000,"minimum":1,"type":"integer"},{"type":"null"}],"default":50,"description":"How many results to return (1 to 1000).","title":"Page Size"},"page_token":{"anyOf":[{"maxLength":300,"type":"string"},{"type":"null"}],"default":null,"description":"Paging token: take the PageToken value from next_page_uri in the previous answer (leave empty for the first page).","title":"Page Token"}},"required":["account_sid"],"title":"list_incoming_numbersArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_local_numbers":{"post":{"operationId":"list_local_numbers","summary":"List the owned local-type phone numbers only. Use for \"Which local numbers do I own in Twilio\".","description":"List the owned local-type phone numbers only. Use for \"Which local numbers do I own in Twilio\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"account_sid":{"description":"The Twilio Account SID: 'AC' followed by 32 hex characters (shown on the Twilio console home page).","maxLength":34,"title":"Account Sid","type":"string"},"phone_number":{"anyOf":[{"maxLength":20,"type":"string"},{"type":"null"}],"default":null,"description":"Only numbers matching this E.164 number (partial numbers allowed, * is a one-digit wildcard).","title":"Phone Number"},"friendly_name":{"anyOf":[{"maxLength":64,"type":"string"},{"type":"null"}],"default":null,"description":"Only numbers with this friendly name.","title":"Friendly Name"},"origin":{"anyOf":[{"enum":["twilio","hosted"],"type":"string"},{"type":"null"}],"default":null,"description":"Only numbers from this origin: twilio or hosted.","title":"Origin"},"page_size":{"anyOf":[{"maximum":1000,"minimum":1,"type":"integer"},{"type":"null"}],"default":50,"description":"How many results to return (1 to 1000).","title":"Page Size"},"page_token":{"anyOf":[{"maxLength":300,"type":"string"},{"type":"null"}],"default":null,"description":"Paging token: take the PageToken value from next_page_uri in the previous answer (leave empty for the first page).","title":"Page Token"}},"required":["account_sid"],"title":"list_local_numbersArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_mobile_numbers":{"post":{"operationId":"list_mobile_numbers","summary":"List the owned mobile-type phone numbers only. Use for \"Which mobile numbers do I own in Twilio\".","description":"List the owned mobile-type phone numbers only. Use for \"Which mobile numbers do I own in Twilio\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"account_sid":{"description":"The Twilio Account SID: 'AC' followed by 32 hex characters (shown on the Twilio console home page).","maxLength":34,"title":"Account Sid","type":"string"},"phone_number":{"anyOf":[{"maxLength":20,"type":"string"},{"type":"null"}],"default":null,"description":"Only numbers matching this E.164 number (partial numbers allowed, * is a one-digit wildcard).","title":"Phone Number"},"friendly_name":{"anyOf":[{"maxLength":64,"type":"string"},{"type":"null"}],"default":null,"description":"Only numbers with this friendly name.","title":"Friendly Name"},"origin":{"anyOf":[{"enum":["twilio","hosted"],"type":"string"},{"type":"null"}],"default":null,"description":"Only numbers from this origin: twilio or hosted.","title":"Origin"},"page_size":{"anyOf":[{"maximum":1000,"minimum":1,"type":"integer"},{"type":"null"}],"default":50,"description":"How many results to return (1 to 1000).","title":"Page Size"},"page_token":{"anyOf":[{"maxLength":300,"type":"string"},{"type":"null"}],"default":null,"description":"Paging token: take the PageToken value from next_page_uri in the previous answer (leave empty for the first page).","title":"Page Token"}},"required":["account_sid"],"title":"list_mobile_numbersArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_toll_free_numbers":{"post":{"operationId":"list_toll_free_numbers","summary":"List the owned toll-free phone numbers only. Use for \"Which toll-free numbers do I own in Twilio\".","description":"List the owned toll-free phone numbers only. Use for \"Which toll-free numbers do I own in Twilio\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"account_sid":{"description":"The Twilio Account SID: 'AC' followed by 32 hex characters (shown on the Twilio console home page).","maxLength":34,"title":"Account Sid","type":"string"},"phone_number":{"anyOf":[{"maxLength":20,"type":"string"},{"type":"null"}],"default":null,"description":"Only numbers matching this E.164 number (partial numbers allowed, * is a one-digit wildcard).","title":"Phone Number"},"friendly_name":{"anyOf":[{"maxLength":64,"type":"string"},{"type":"null"}],"default":null,"description":"Only numbers with this friendly name.","title":"Friendly Name"},"origin":{"anyOf":[{"enum":["twilio","hosted"],"type":"string"},{"type":"null"}],"default":null,"description":"Only numbers from this origin: twilio or hosted.","title":"Origin"},"page_size":{"anyOf":[{"maximum":1000,"minimum":1,"type":"integer"},{"type":"null"}],"default":50,"description":"How many results to return (1 to 1000).","title":"Page Size"},"page_token":{"anyOf":[{"maxLength":300,"type":"string"},{"type":"null"}],"default":null,"description":"Paging token: take the PageToken value from next_page_uri in the previous answer (leave empty for the first page).","title":"Page Token"}},"required":["account_sid"],"title":"list_toll_free_numbersArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_incoming_number":{"post":{"operationId":"get_incoming_number","summary":"Get one owned phone number by SID: capabilities, status, origin, trunk, emergency status and bundle. Use for \"What can p","description":"Get one owned phone number by SID: capabilities, status, origin, trunk, emergency status and bundle. Use for \"What can phone number PN... do\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"account_sid":{"description":"The Twilio Account SID: 'AC' followed by 32 hex characters (shown on the Twilio console home page).","maxLength":34,"title":"Account Sid","type":"string"},"sid":{"description":"The SID of the phone number: 'PN' followed by 32 hex characters.","maxLength":34,"title":"Sid","type":"string"}},"required":["account_sid","sid"],"title":"get_incoming_numberArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_outgoing_caller_ids":{"post":{"operationId":"list_outgoing_caller_ids","summary":"List verified outgoing caller IDs (numbers you may present as caller ID without owning them). Use for \"Which caller IDs ","description":"List verified outgoing caller IDs (numbers you may present as caller ID without owning them). Use for \"Which caller IDs have I verified in Twilio\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"account_sid":{"description":"The Twilio Account SID: 'AC' followed by 32 hex characters (shown on the Twilio console home page).","maxLength":34,"title":"Account Sid","type":"string"},"phone_number":{"anyOf":[{"maxLength":20,"type":"string"},{"type":"null"}],"default":null,"description":"Only this E.164 number.","title":"Phone Number"},"friendly_name":{"anyOf":[{"maxLength":64,"type":"string"},{"type":"null"}],"default":null,"description":"Only caller IDs with this name.","title":"Friendly Name"},"page_size":{"anyOf":[{"maximum":1000,"minimum":1,"type":"integer"},{"type":"null"}],"default":50,"description":"How many results to return (1 to 1000).","title":"Page Size"},"page_token":{"anyOf":[{"maxLength":300,"type":"string"},{"type":"null"}],"default":null,"description":"Paging token: take the PageToken value from next_page_uri in the previous answer (leave empty for the first page).","title":"Page Token"}},"required":["account_sid"],"title":"list_outgoing_caller_idsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_short_codes":{"post":{"operationId":"list_short_codes","summary":"List the SMS short codes assigned to the account. Use for \"Which short codes does my Twilio account have\".","description":"List the SMS short codes assigned to the account. Use for \"Which short codes does my Twilio account have\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"account_sid":{"description":"The Twilio Account SID: 'AC' followed by 32 hex characters (shown on the Twilio console home page).","maxLength":34,"title":"Account Sid","type":"string"},"friendly_name":{"anyOf":[{"maxLength":64,"type":"string"},{"type":"null"}],"default":null,"description":"Only short codes with this name.","title":"Friendly Name"},"short_code":{"anyOf":[{"maxLength":10,"type":"string"},{"type":"null"}],"default":null,"description":"Only short codes matching this pattern.","title":"Short Code"},"page_size":{"anyOf":[{"maximum":1000,"minimum":1,"type":"integer"},{"type":"null"}],"default":50,"description":"How many results to return (1 to 1000).","title":"Page Size"},"page_token":{"anyOf":[{"maxLength":300,"type":"string"},{"type":"null"}],"default":null,"description":"Paging token: take the PageToken value from next_page_uri in the previous answer (leave empty for the first page).","title":"Page Token"}},"required":["account_sid"],"title":"list_short_codesArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_available_countries":{"post":{"operationId":"list_available_countries","summary":"List countries where Twilio has numbers to rent, with country code. Use for \"In which countries can I rent Twilio number","description":"List countries where Twilio has numbers to rent, with country code. Use for \"In which countries can I rent Twilio numbers\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"account_sid":{"description":"The Twilio Account SID: 'AC' followed by 32 hex characters (shown on the Twilio console home page).","maxLength":34,"title":"Account Sid","type":"string"},"page_size":{"anyOf":[{"maximum":1000,"minimum":1,"type":"integer"},{"type":"null"}],"default":50,"description":"How many results to return (1 to 1000).","title":"Page Size"},"page_token":{"anyOf":[{"maxLength":300,"type":"string"},{"type":"null"}],"default":null,"description":"Paging token: take the PageToken value from next_page_uri in the previous answer (leave empty for the first page).","title":"Page Token"}},"required":["account_sid"],"title":"list_available_countriesArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/search_available_local_numbers":{"post":{"operationId":"search_available_local_numbers","summary":"Search local phone numbers available to rent in one country, by area code, digit pattern, capability or region. Only sea","description":"Search local phone numbers available to rent in one country, by area code, digit pattern, capability or region. Only searches; nothing is purchased. Use for \"Find a 415 number I can get in the US\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"account_sid":{"description":"The Twilio Account SID: 'AC' followed by 32 hex characters (shown on the Twilio console home page).","maxLength":34,"title":"Account Sid","type":"string"},"country_code":{"description":"Country as an ISO 3166-1 alpha-2 code, for example 'US' or 'GB'.","maxLength":2,"title":"Country Code","type":"string"},"area_code":{"anyOf":[{"maximum":999,"minimum":100,"type":"integer"},{"type":"null"}],"default":null,"description":"US or Canada area code, for example 415.","title":"Area Code"},"contains":{"anyOf":[{"maxLength":16,"type":"string"},{"type":"null"}],"default":null,"description":"Digit pattern the number must contain (2 to 16 characters, * is a wildcard).","title":"Contains"},"sms_enabled":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"description":"True to return only numbers that can receive SMS.","title":"Sms Enabled"},"voice_enabled":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"description":"True to return only numbers that can receive calls.","title":"Voice Enabled"},"in_region":{"anyOf":[{"maxLength":40,"type":"string"},{"type":"null"}],"default":null,"description":"Only numbers in this state or province, for example CA.","title":"In Region"},"in_postal_code":{"anyOf":[{"maxLength":20,"type":"string"},{"type":"null"}],"default":null,"description":"Only numbers in this postal code.","title":"In Postal Code"},"page_size":{"anyOf":[{"maximum":1000,"minimum":1,"type":"integer"},{"type":"null"}],"default":50,"description":"How many results to return (1 to 1000).","title":"Page Size"},"page_token":{"anyOf":[{"maxLength":300,"type":"string"},{"type":"null"}],"default":null,"description":"Paging token: take the PageToken value from next_page_uri in the previous answer (leave empty for the first page).","title":"Page Token"}},"required":["account_sid","country_code"],"title":"search_available_local_numbersArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/search_available_toll_free_numbers":{"post":{"operationId":"search_available_toll_free_numbers","summary":"Search toll-free phone numbers available to rent in one country. Only searches; nothing is purchased. Use for \"Find toll","description":"Search toll-free phone numbers available to rent in one country. Only searches; nothing is purchased. Use for \"Find toll-free numbers with 800 available in the US\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"account_sid":{"description":"The Twilio Account SID: 'AC' followed by 32 hex characters (shown on the Twilio console home page).","maxLength":34,"title":"Account Sid","type":"string"},"country_code":{"description":"Country as an ISO 3166-1 alpha-2 code, for example 'US' or 'GB'.","maxLength":2,"title":"Country Code","type":"string"},"area_code":{"anyOf":[{"maximum":999,"minimum":100,"type":"integer"},{"type":"null"}],"default":null,"description":"US or Canada area code, for example 415.","title":"Area Code"},"contains":{"anyOf":[{"maxLength":16,"type":"string"},{"type":"null"}],"default":null,"description":"Digit pattern the number must contain (2 to 16 characters, * is a wildcard).","title":"Contains"},"sms_enabled":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"description":"True to return only numbers that can receive SMS.","title":"Sms Enabled"},"voice_enabled":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"description":"True to return only numbers that can receive calls.","title":"Voice Enabled"},"in_region":{"anyOf":[{"maxLength":40,"type":"string"},{"type":"null"}],"default":null,"description":"Only numbers in this state or province, for example CA.","title":"In Region"},"in_postal_code":{"anyOf":[{"maxLength":20,"type":"string"},{"type":"null"}],"default":null,"description":"Only numbers in this postal code.","title":"In Postal Code"},"page_size":{"anyOf":[{"maximum":1000,"minimum":1,"type":"integer"},{"type":"null"}],"default":50,"description":"How many results to return (1 to 1000).","title":"Page Size"},"page_token":{"anyOf":[{"maxLength":300,"type":"string"},{"type":"null"}],"default":null,"description":"Paging token: take the PageToken value from next_page_uri in the previous answer (leave empty for the first page).","title":"Page Token"}},"required":["account_sid","country_code"],"title":"search_available_toll_free_numbersArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/search_available_mobile_numbers":{"post":{"operationId":"search_available_mobile_numbers","summary":"Search mobile-type phone numbers available to rent in one country. Only searches; nothing is purchased. Use for \"Find mo","description":"Search mobile-type phone numbers available to rent in one country. Only searches; nothing is purchased. Use for \"Find mobile numbers I can rent in the UK\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"account_sid":{"description":"The Twilio Account SID: 'AC' followed by 32 hex characters (shown on the Twilio console home page).","maxLength":34,"title":"Account Sid","type":"string"},"country_code":{"description":"Country as an ISO 3166-1 alpha-2 code, for example 'US' or 'GB'.","maxLength":2,"title":"Country Code","type":"string"},"area_code":{"anyOf":[{"maximum":999,"minimum":100,"type":"integer"},{"type":"null"}],"default":null,"description":"US or Canada area code, for example 415.","title":"Area Code"},"contains":{"anyOf":[{"maxLength":16,"type":"string"},{"type":"null"}],"default":null,"description":"Digit pattern the number must contain (2 to 16 characters, * is a wildcard).","title":"Contains"},"sms_enabled":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"description":"True to return only numbers that can receive SMS.","title":"Sms Enabled"},"voice_enabled":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"description":"True to return only numbers that can receive calls.","title":"Voice Enabled"},"in_region":{"anyOf":[{"maxLength":40,"type":"string"},{"type":"null"}],"default":null,"description":"Only numbers in this state or province, for example CA.","title":"In Region"},"in_postal_code":{"anyOf":[{"maxLength":20,"type":"string"},{"type":"null"}],"default":null,"description":"Only numbers in this postal code.","title":"In Postal Code"},"page_size":{"anyOf":[{"maximum":1000,"minimum":1,"type":"integer"},{"type":"null"}],"default":50,"description":"How many results to return (1 to 1000).","title":"Page Size"},"page_token":{"anyOf":[{"maxLength":300,"type":"string"},{"type":"null"}],"default":null,"description":"Paging token: take the PageToken value from next_page_uri in the previous answer (leave empty for the first page).","title":"Page Token"}},"required":["account_sid","country_code"],"title":"search_available_mobile_numbersArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}}}}