From 6c46f20288706eb90db922bd72d7d69e8a40148b Mon Sep 17 00:00:00 2001 From: Maksym Mateiuk <41195182+maksymmateiuk@users.noreply.github.com> Date: Mon, 26 Sep 2022 22:41:06 +0300 Subject: [PATCH] api_reference-last tags (#729) --- site/specs-temp/numbers.json | 211 +++++++++++++++++++---------------- 1 file changed, 116 insertions(+), 95 deletions(-) diff --git a/site/specs-temp/numbers.json b/site/specs-temp/numbers.json index 3720c8fa5..044439c43 100644 --- a/site/specs-temp/numbers.json +++ b/site/specs-temp/numbers.json @@ -21,7 +21,7 @@ "/accounts/{accountId}": { "get": { "tags": [ - "/accounts" + "Account" ], "description": "
The account is the root resource for many of the operations in the Bandwidth Dashboard API.
The account is represented by an account id, which is the resource that represents a Bandwidth customer, providing a root resource for all of the customer's attributes and services.
The API calls that are used to manage the details of a customer account, and to manage the resources that a Bandwidth customer has access to or control over, are accessed through the /accounts resource.
This API call retrieves information about the account indicated by the Account ID.
", "operationId": "GetAccount", @@ -995,7 +995,7 @@ "/accounts/{accountId}/availableNpaNxx": { "get": { "tags": [ - "/accounts" + "Available Tns" ], "description": "Retrieves a list of available Npa-Nxx telephone numbers.", "operationId": "GetAvailableNpaNxx", @@ -1072,7 +1072,7 @@ "/accounts/{accountId}/availableNumbers": { "get": { "tags": [ - "/accounts" + "Available Tns" ], "description": "Retrieves the phone numbers according to the input parameters.\nIn this table are presented combinations of path parameters for different type of search:
Search Type | Required Parameters | Combinational Parameters | Optional Parameters |
---|---|---|---|
Area Code | areaCode | rateCenter (state required), city (state required), state, lata, zip | quantity, enableTNDetail, protected |
NPA-NXX | npaNxx | rateCenter (state required), city (state required), state, lata, zip, orderBy | quantity, enableTNDetail, protected |
NPA-NXX with Local Calling Area | npaNxx | quantity, LCA, enableTNDetail, protected | |
NPA-NXX-X | npaNxxx | rateCenter (state required), city (state required), state, lata, zip, orderBy | quantity, enableTNDetail, protected |
NPA-NXX-X with Local Calling Area | npaNxxx | rateCenter (state required), city (state required), state, lata, zip | quantity, LCA, enableTNDetail, protected |
RateCenter | rateCenter, state | city, areaCode/npaNxx/npaNxxx, lata, zip, orderBy | quantity, enableTNDetail, protected |
RateCenter with Local Calling Area | rateCenter, state | quantity, LCA, enableTNDetail, protected | |
State | state | rateCenter, city, areaCode/npaNxx/npaNxxx, lata, zip | quantity, enableTNDetail, protected |
City | state, city | rateCenter, state, areaCode/npaNxx/npaNxxx, lata, zip, orderBy | quantity, enableTNDetail, protected |
Zip Code | zip | rateCenter (state required), city (state required), state, areaCode/npaNxx/npaNxxx, lata, orderBy | quantity, enableTNDetail, protected |
LATA | lata | rateCenter (state required), city (state required), state, areaCode/npaNxx/npaNxxx, zip | quantity, enableTNDetail, protected |
Local Vanity | localVanity | state, areaCode | endsIn, quantity, protected, enableTNdetails |
TollFree Vanity | tollFreeVanity | orderBy | quantity |
TollFree WildCard | tollFreeWildCardPattern | orderBy | quantity |
Numbers can be moved to sites/sippeers of a different account (if the user has access to both accounts and the proper roles). This can be done by specifying the SourceAccountId parameter. The user can also specify how to handle E911 service on the number (if it exists) using the optional e911ServiceAction parameter", "summary": "Move Telephone Numbers", @@ -8801,7 +8801,7 @@ "/accounts/{accountId}/moveTns/{orderId}": { "get": { "tags": [ - "/accounts" + "Move Tns" ], "description": "Retrieve information about a MoveTnsOrder with specified ID", "summary": "Fetching Move Telephone Numbers order status", @@ -8843,7 +8843,7 @@ "/accounts/{accountId}/moveTns/{orderId}/history": { "get": { "tags": [ - "/accounts" + "Move Tns" ], "description": "Retrieves the history of the specified MoveTnsOrder", "summary": "Fetching Move Telephone Numbers order history", @@ -8885,7 +8885,7 @@ "/accounts/{accountId}/numbersAssignment": { "get": { "tags": [ - "/accounts" + "Numbers Assignment" ], "description": "Retrieve a list of the TelephoneNumbersAssignment orders that are associated with the account. A maximum of 1,000 orders can be retrieved per request. If no date range or specific query parameter is provided, the order results will be limited to the last two years.", "summary": "List Telephone Numbers Assignment Orders", @@ -9021,7 +9021,7 @@ }, "post": { "tags": [ - "/accounts" + "Numbers Assignment" ], "description": "Create a TelephoneNumbersAssignment order to register the assignment status of a list of telephone numbers.", "summary": "Telephone Numbers Assignment Order", @@ -9085,7 +9085,7 @@ "/accounts/{accountId}/numbersAssignment/{orderid}": { "get": { "tags": [ - "/accounts" + "Numbers Assignment" ], "description": "Retrieve information about a TelephoneNumbersAssignment order with specified ID.", "summary": "Fetching Telephone Numbers Assignment Order status", @@ -9144,7 +9144,7 @@ "/accounts/{accountId}/orders": { "get": { "tags": [ - "/accounts" + "Orders" ], "description": "GET is used to retrieve order ids and order details for previously attempted Telephone Number orders. A maximum of 1,000 orders can be retrieved per request. If no date range or specific query parameter (marked by * below) is provided, the order results will be limited to the last two years.
Please visit Guides and Tutorials to learn more.
", "operationId": "ListOrders", @@ -9253,7 +9253,7 @@ }, "post": { "tags": [ - "/accounts" + "Orders" ], "description": "A POST creates a request for Telephone Numbers\nPlease visit Guides and Tutorials to learn more.
", "operationId": "CreateOrder", @@ -9369,7 +9369,7 @@ "/accounts/{accountId}/orders/{orderid}": { "get": { "tags": [ - "/accounts" + "Orders" ], "description": "GET all of the details associated with an identified order.Please visit Guides and Tutorials to learn more.
", "operationId": "RetrieveOrder", @@ -9421,7 +9421,7 @@ }, "put": { "tags": [ - "/accounts" + "Orders" ], "description": "With the introduction of Backorder capabilities, new number orders may stay in backordered state while the order is filled. While in this state it is possible to update the modifiable fields in the record, as well as to request that backorder processing of the order be ended.\nThe fields that can be updated are...\n\nPlease visit Guides and Tutorials to learn more.
", "operationId": "UpdateOrder", @@ -9483,7 +9483,7 @@ "/accounts/{accountId}/orders/{orderid}/areaCodes": { "get": { "tags": [ - "/accounts" + "Orders" ], "description": "Retrieves the area codes of the phone numbers from the specified order.Please visit Guides and Tutorials to learn more.
", "operationId": "ListOrderAreaCodes", @@ -9526,7 +9526,7 @@ "/accounts/{accountId}/orders/{orderid}/npaNxx": { "get": { "tags": [ - "/accounts" + "Orders" ], "description": "Retrieves the Npa-Nxx of the phone numbers from the specified order.Please visit Guides and Tutorials to learn more.
", "summary": "List Telephone Number order Npa-Nxx", @@ -9569,7 +9569,7 @@ "/accounts/{accountId}/orders/{orderid}/totals": { "get": { "tags": [ - "/accounts" + "Orders" ], "description": "Retrieves the total quantity of phone numbers from the specified Telephone Number order.Please visit Guides and Tutorials to learn more.
", "operationId": "RetrieveOrderTotals", @@ -9612,7 +9612,7 @@ "/accounts/{accountId}/orders/{orderid}/tns": { "get": { "tags": [ - "/accounts" + "Orders" ], "description": "Returns a list of phone numbers associated with the ID of a given Telephone Number order.Please visit Guides and Tutorials to learn more.
", "operationId": "ListOrderTns", @@ -9655,7 +9655,7 @@ "/accounts/{accountId}/orders/{orderid}/notes": { "get": { "tags": [ - "/accounts" + "Orders" ], "description": "Retrieve all notes associated with the order.Please visit Guides and Tutorials to learn more.
", "operationId": "ListOrderNotes", @@ -9706,7 +9706,7 @@ }, "post": { "tags": [ - "/accounts" + "Orders" ], "description": "Updates the Notes resource by adding a note. Adding a note to order causes a notification to be sent to Bandwidth Operations, so that they may assist as necessary. A note may be up to 500 characters in length.Please visit Guides and Tutorials to learn more.
", "operationId": "CreateOrderNote", @@ -9767,7 +9767,7 @@ "/accounts/{accountId}/orders/{orderid}/notes/{noteId}": { "put": { "tags": [ - "/accounts" + "Orders" ], "description": "Update a specified note. Notes may only be updated, not deleted.Please visit Guides and Tutorials to learn more.
", "operationId": "UpdateOrderNote", @@ -9838,7 +9838,7 @@ "/accounts/{accountId}/orders/{orderid}/history": { "get": { "tags": [ - "/accounts" + "Orders" ], "description": "Retrieve the history information associated with an order.Please visit Guides and Tutorials to learn more.
", "operationId": "RetrieveOrderHistory", @@ -9897,7 +9897,7 @@ "/accounts/{accountId}/orders/totals": { "get": { "tags": [ - "/accounts" + "Orders" ], "description": "Retrieves a total number of tn orders.", "summary": "Get New Number Order TN Count Totals", @@ -11789,7 +11789,7 @@ "/accounts/{accountId}/products": { "get": { "tags": [ - "/accounts" + "Account" ], "description": "Discover what is currently enabled on the account\n", "operationId": "ListProducts", @@ -11822,7 +11822,7 @@ "/accounts/{accountId}/products/{productName}": { "get": { "tags": [ - "/accounts" + "Account" ], "description": "Discover whether product is currently enabled on the account", "operationId": "GetAccountProduct", @@ -11857,7 +11857,7 @@ "/accounts/{accountId}/products/e911/settings": { "get": { "tags": [ - "/accounts" + "Account" ], "description": "Retrieve the current host and EVS credentials settings that are used only for e911 traffic. This includes host details, EVS account ID information (including accounts where the Dashboard ID differs from the EVS ID), and the EVS route type", "operationId": "GetAccountE911ProductSettings", @@ -11889,7 +11889,7 @@ "/accounts/{accountId}/products/edgemanagement/settings": { "get": { "tags": [ - "/accounts" + "Account" ], "description": "Retrieve settings that are provided as part of the Edge Management product: The SBC settings that are associated with the account, SipAuthentication that provide settings for SIP authentication and ProductSpecificAccessRestrictions that can restrict Termination traffic for sipCredendital.", "operationId": "GetAccountEdgemanagementProductSettings", @@ -11921,7 +11921,7 @@ "/accounts/{accountId}/products/edgemanagement/settings/sipauthentication": { "get": { "tags": [ - "/accounts" + "Account" ], "description": "Retrieve existing SIP authentication configuration on account.", "operationId": "GetAccountEdgemanagementProductSettingsSipauthentication", @@ -11953,7 +11953,7 @@ "/accounts/{accountId}/products/messaging/a2pCampaigns": { "get": { "tags": [ - "/accounts" + "Account" ], "description": "Retrieve existing a2pCampaigns configuration on account.", "operationId": "GetAccountMessagingProductA2pCampaings", @@ -11985,7 +11985,7 @@ "/accounts/{accountId}/products/messaging/features/http": { "get": { "tags": [ - "/accounts" + "Account" ], "description": "Retrieve existing messaging http configuration on account.", "operationId": "GetAccountMessagingProductFeatureHttp", @@ -12017,7 +12017,7 @@ "/accounts/{accountId}/products/messaging/features/mms": { "get": { "tags": [ - "/accounts" + "Account" ], "description": "Retrieve existing messaging mms configuration on account.", "operationId": "GetAccountMessagingProductFeatureMms", @@ -12049,7 +12049,7 @@ "/accounts/{accountId}/products/messaging/features/mms/mm4settings": { "get": { "tags": [ - "/accounts" + "Account" ], "description": "Retrieve existing messaging mm4settings configuration on account.", "operationId": "GetAccountMessagingProductFeatureMm4settings", @@ -12081,7 +12081,7 @@ "/accounts/{accountId}/products/messaging/features/mms/settings": { "get": { "tags": [ - "/accounts" + "Account" ], "description": "Retrieve existing messaging mms feature settings on account.", "operationId": "GetAccountMessagingProductFeatureMmsSettings", @@ -12113,7 +12113,7 @@ "/accounts/{accountId}/products/messaging/features/sms": { "get": { "tags": [ - "/accounts" + "Account" ], "description": "Retrieve existing messaging sms configuration on account.", "operationId": "GetAccountMessagingProductFeatureSms", @@ -12145,7 +12145,7 @@ "/accounts/{accountId}/products/messaging/routes": { "get": { "tags": [ - "/accounts" + "Account" ], "description": "Retrieve the current list of routes associated with the various types of TNs that can be assigned messaging routes. Zero or more routes can be returned for each type of TN; each one of these routes is identified by an NNID, or an ESPID while we transition from ESPIDs to NNIDs.", "operationId": "GetAccountMessagingProductRoutes", @@ -12177,7 +12177,7 @@ "/accounts/{accountId}/products/messaging/settings": { "get": { "tags": [ - "/accounts" + "Account" ], "description": "Retrieve the current settings, indicating is Messaging product enabled now and if yes will Messaging feature be enabled on each new telephone number.", "operationId": "GetAccountMessagingProductSettings", @@ -14339,7 +14339,7 @@ "/accounts/{accountId}/sites": { "get": { "tags": [ - "/accounts" + "Site Management" ], "description": "Retrieve a list of all Sites associated with the account", "summary": "List Sites", @@ -14402,7 +14402,7 @@ }, "post": { "tags": [ - "/accounts" + "Site Management" ], "description": "Add a Site to the account", "summary": "Create Site", @@ -14527,7 +14527,7 @@ "/accounts/{accountId}/sites/{siteId}": { "get": { "tags": [ - "/accounts" + "Site Management" ], "description": "Retrieves the information associated with the Site id", "summary": "Retrieve Site", @@ -14585,7 +14585,7 @@ }, "put": { "tags": [ - "/accounts" + "Site Management" ], "description": "Updates the contents of Site", "summary": "Update Site", @@ -14718,7 +14718,7 @@ }, "delete": { "tags": [ - "/accounts" + "Site Management" ], "description": "Deletes the Site. Sites can only be deleted if there are no SIP Peers attached to it", "summary": "Delete Site", @@ -14763,7 +14763,7 @@ "/accounts/{accountId}/sites/{siteId}/sippeers": { "get": { "tags": [ - "/accounts" + "SipPeer Management" ], "description": "Retrieve information about a Sip Peer or set of Sip Peers on Site", "summary": "List Sip Peers", @@ -14803,7 +14803,7 @@ }, "post": { "tags": [ - "/accounts" + "SipPeer Management" ], "description": "Create Sip Peer", "summary": "Create Sip Peer", @@ -15049,7 +15049,7 @@ "/accounts/{accountId}/sites/{siteId}/sippeers/{sippeerId}": { "get": { "tags": [ - "/accounts" + "SipPeer Management" ], "description": "Retrieves the information associated with the sip peer id", "summary": "Retrieve Sip Peer", @@ -15107,7 +15107,7 @@ }, "put": { "tags": [ - "/accounts" + "SipPeer Management" ], "description": "Update Sip Peer\nThere are a few rules used to eliminate IP address collisions. The primary restriction is on the ability to share Term IP addresses across the Bandwidth Dashboard API structural elements. Essentially...\n\nNote: Changing the Voice Protocol from SIP to HTTP will remove Voice Hosts or Voice Host Groups and Termination Hosts, which are configured using API /accounts/{accountId}/sites/{siteId}/sippeers/{sippeerId}.
", "summary": "Update Sip Peer Origination setting", @@ -15716,7 +15716,7 @@ "/accounts/{accountId}/sites/{siteId}/sippeers/{sippeerId}/products/termination/settings": { "get": { "tags": [ - "/accounts" + "SipPeer Management" ], "description": "Retrieve Sip Peer Termination settings", "summary": "Retrieve Sip Peer Termination setting", @@ -15762,7 +15762,7 @@ }, "post": { "tags": [ - "/accounts" + "SipPeer Management" ], "description": "Create Sip Peer Termination settings", "summary": "Create Sip Peer Termination setting", @@ -15834,7 +15834,7 @@ }, "put": { "tags": [ - "/accounts" + "SipPeer Management" ], "description": "Update Sip Peer Termination settingsNote: Changing the Voice Protocol from SIP to HTTP will remove Voice Hosts or Voice Host Groups and Termination Hosts, which are configured using API /accounts/{accountId}/sites/{siteId}/sippeers/{sippeerId}.
", "summary": "Update Sip Peer Termination setting", @@ -15884,7 +15884,7 @@ "/accounts/{accountId}/sites/{siteId}/sippeers/{sippeerId}/products/messaging/features/sms": { "get": { "tags": [ - "/accounts" + "SipPeer Management" ], "description": "Retrieve Sip Peer SMS settings", "summary": "Retrieve Sip Peer SMS setting", @@ -15927,7 +15927,7 @@ }, "post": { "tags": [ - "/accounts" + "SipPeer Management" ], "description": "Create Sip Peer SMS settings