Create a DECT Network
Create a multi-cell DECT network for a given location.
Creating a DECT network requires a full administrator auth token with a scope of spark-admin:telephony_config_write
.
URI Parameters
Create a DECT network in this location.
Query Parameters
Create a DECT network in this organization.
Body Parameters
Name of the DECT network. Min and max length supported for the DECT network name are 1 and 40 respectively.
Add a default name (11 characters max) to display for all handsets. If left blank, the default name will be an indexed number followed by the DECT network name.
Select a device model type depending on the number of base stations and handset lines needed in the DECT network.
Supports 1 base station and 30 line ports.
Supports 250 base stations and 1000 line ports.
If set to true, need to provide a default access code that will be shared for all users in this network to pair their lines to the next available handset. Otherwise, each user will get a unique 4-digit access code that will be auto-generated. Note: There is currently no public API to retrieve the auto generated access codes for handsets. Use Control Hub instead.
If defaultAccessCodeEnabled
is set to true, then provide a default access code that needs to be a 4-numeric digit. The access code should be unique to the DECT network for the location.
Response Properties
A unique identifier for the DECT network.
Response Codes
The list below describes the common success and error responses you should expect from the API.
Code | Status | Description |
---|---|---|
200 | OK | Successful request with body content. |
201 | Created | The request has succeeded and has led to the creation of a resource. |
202 | Accepted | The request has been accepted for processing. |
204 | No Content | Successful request without body content. |
400 | Bad Request | The request was invalid or cannot be otherwise served. An accompanying error message will explain further. |
401 | Unauthorized | Authentication credentials were missing or incorrect. |
403 | Forbidden | The request is understood, but it has been refused or access is not allowed. |
404 | Not Found | The URI requested is invalid or the resource requested, such as a user, does not exist. Also returned when the requested format is not supported by the requested method. |
405 | Method Not Allowed | The request was made to a resource using an HTTP request method that is not supported. |
409 | Conflict | The request could not be processed because it conflicts with some established rule of the system. For example, a person may not be added to a room more than once. |
410 | Gone | The requested resource is no longer available. |
415 | Unsupported Media Type | The request was made to a resource without specifying a media type or used a media type that is not supported. |
423 | Locked | The requested resource is temporarily unavailable. A Retry-After header may be present that specifies how many seconds you need to wait before attempting the request again. |
428 | Precondition Required | File(s) cannot be scanned for malware and need to be force downloaded. |
429 | Too Many Requests | Too many requests have been sent in a given amount of time and the request has been rate limited. A Retry-After header should be present that specifies how many seconds you need to wait before a successful request can be made. |
500 | Internal Server Error | Something went wrong on the server. If the issue persists, feel free to contact the Webex Developer Support team. |
502 | Bad Gateway | The server received an invalid response from an upstream server while processing the request. Try again later. |
503 | Service Unavailable | Server is overloaded with requests. Try again later. |
504 | Gateway Timeout | An upstream server failed to respond on time. If your query uses max parameter, please try to reduce it. |
Header
Query Parameters
- orgIdstringCreate a DECT network in this organization.
Body
- namestringRequiredName of the DECT network. Min and max length supported for the DECT network name are 1 and 40 respectively.
- displayNamestringAdd a default name (11 characters max) to display for all handsets. If left blank, the default name will be an indexed number followed by the DECT network name.
- modelenumRequiredSelect a device model type depending on the number of base stations and handset lines needed in the DECT network.
- defaultAccessCodeEnabledbooleanRequiredIf set to true, need to provide a default access code that will be shared for all users in this network to pair their lines to the next available handset. Otherwise, each user will get a unique 4-digit access code that will be auto-generated. Note: There is currently no public API to retrieve the auto generated access codes for handsets. Use Control Hub instead.
- defaultAccessCodestringRequiredIf `defaultAccessCodeEnabled` is set to true, then provide a default access code that needs to be a 4-numeric digit. The access code should be unique to the DECT network for the location.
{ "name": "test-dect", "displayName": "test-dect", "model" : "DMS Cisco DBS210", "defaultAccessCodeEnabled": true, "defaultAccessCode": "1551" }
{ "dectNetworkId": "Y2lzY29zcGFyazovL3VzL0RFQ1RfREVWX05FVC81NmRiMjRkMy03YTdhLTQwYTItOWFjOS1iMjMzMjc3OTIxNzf" }