openapi: 3.0.0
info:
title: Webex Admin Address Book Dial Number API
version: 1.0.0
description: The Webex Admin APIs provide comprehensive programmatic access to administrative functions for managing Webex organizations, users, licenses, and settings. These APIs enable automation of user provisioning, license assignment, compliance management, and audit event retrieval. Administrators can integrate with enterprise identity systems, enforce security policies, monitor usage, and streamline onboarding/offboarding processes. The APIs support granular control over organizational resources, making them ideal for large-scale deployments and custom admin tooling.
tags:
- name: Dial Number
paths:
/organization/{orgid}/dial-number:
get:
tags:
- Dial Number
summary: List Dialed Number Mapping(s)
description: Retrieve a list of Dialed Number Mapping(s) in a given organization.
operationId: getAllConfig_9
parameters:
- name: orgid
in: path
description: Organization ID to be used for this operation. The specified security token must have permission to interact with the organization.
required: true
schema:
type: string
example: 2f9eecc5-0472-4549-9a83-2afdae0d4ba1
- name: filter
in: query
description: "Specify a filter based on which the results will be fetched. Supported filterable fields: id. \n\nThe examples below show some search queries\n- id==\"57efb0e6-5af0-4245-a67d-d3c5045cdb6e\"\n- id!=\"57efb0e6-5af0-4245-a67d-d3c5045cdb6e\"\n- id=in=(\"57efb0e6-5af0-4245-a67d-d3c5045cdb6e\",\"a421e0b2-732e-46f3-a057-39160a53afb9\")\n- id=out=(\"57efb0e6-5af0-4245-a67d-d3c5045cdb6e\",\"a421e0b2-732e-46f3-a057-39160a53afb9\")\nThis parameter uses the RSQL query syntax, a URI-friendly format for expressing criteria for filtering REST entities. For more information about RSQL in general, see this reference. For a list of supported operators, see this syntax guide.\n\nNote: values to be used in the filter syntax should not contain spaces. If they do, please enclose them in quotes to apply the filter.\n"
required: false
schema:
type: string
example: id=="2f9eecc5-0472-4549-9a83-2afdae0d4ba1"
- name: attributes
in: query
description: Specify the attributes to be returned. By default, all attributes are returned along with the specified columns. All attributes are supported. except (links)
required: false
schema:
type: string
format: string
example: id
- name: page
in: query
description: Defines the number of displayed page. The page number starts from 0.
schema:
type: integer
default: 0
example: 0
example: 0
- name: pageSize
in: query
description: Defines the number of items to be displayed on a page. If the number specified is more than allowed max page size, the API will automatically adjust the page size to the max page size.
schema:
type: integer
default: 100
example: 100
example: 100
responses:
'200':
description: OK
content:
'*/*':
schema:
type: array
items:
$ref: '#/components/schemas/DialledNumberEntryPointDTO'
'401':
description: Unauthorized Operation
content:
application/json:
schema:
$ref: '#/components/schemas/ApiErrorResponse'
example:
trackingId: ccconfig_af9eecc5-0472-4549-9a83-2afdae0d4ba0
error:
key: '401'
reason: Test reason
message:
- description: Test error
code: '401'
entity: cc_user
references: []
'403':
description: Operation is forbidden
content:
application/json:
schema:
$ref: '#/components/schemas/ApiErrorResponse'
example:
trackingId: ccconfig_af9eecc5-0472-4549-9a83-2afdae0d4ba0
error:
key: '403'
reason: Test reason
message:
- description: Test error
code: '403'
entity: cc_user
references: []
'404':
description: Resource not found or URI is invalid
content:
application/json:
schema:
$ref: '#/components/schemas/ApiErrorResponse'
example:
trackingId: ccconfig_af9eecc5-0472-4549-9a83-2afdae0d4ba0
error:
key: '404'
reason: Test reason
message:
- description: Test error
code: '404'
entity: cc_user
references: []
'429':
description: Too many requests have been sent in a given amount of time and the request has been rate limited
content:
application/json:
schema:
$ref: '#/components/schemas/ApiErrorResponse'
example:
trackingId: ccconfig_af9eecc5-0472-4549-9a83-2afdae0d4ba0
error:
key: '429'
reason: Test reason
message:
- description: Test error
code: '429'
entity: cc_user
references: []
'500':
description: An Unexpected Error Occurred
content:
application/json:
schema:
$ref: '#/components/schemas/ApiErrorResponse'
example:
trackingId: ccconfig_af9eecc5-0472-4549-9a83-2afdae0d4ba0
error:
key: '500'
reason: Test reason
message:
- description: Test error
code: '500'
entity: cc_user
references: []
deprecated: false
post:
tags:
- Dial Number
summary: Create a new Dialed Number Mapping
description: Create a new Dialed Number Mapping in a given organization.
operationId: createConfig_14
parameters:
- name: orgid
in: path
description: Organization ID to be used for this operation. The specified security token must have permission to interact with the organization.
required: true
schema:
type: string
example: 2f9eecc5-0472-4549-9a83-2afdae0d4ba1
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/DialledNumberEntryPointDTO'
required: true
responses:
'200':
description: OK
content:
'*/*':
schema:
$ref: '#/components/schemas/DialledNumberEntryPointDTO'
'400':
description: The request was invalid and cannot be served. An accompanying error message will explain further
content:
application/json:
schema:
$ref: '#/components/schemas/ApiErrorResponse'
example:
trackingId: ccconfig_af9eecc5-0472-4549-9a83-2afdae0d4ba0
error:
key: '400'
reason: Test reason
message:
- description: Test error
code: '400'
entity: cc_user
references: []
'401':
description: Unauthorized Operation
content:
application/json:
schema:
$ref: '#/components/schemas/ApiErrorResponse'
example:
trackingId: ccconfig_af9eecc5-0472-4549-9a83-2afdae0d4ba0
error:
key: '401'
reason: Test reason
message:
- description: Test error
code: '401'
entity: cc_user
references: []
'403':
description: Operation is forbidden
content:
application/json:
schema:
$ref: '#/components/schemas/ApiErrorResponse'
example:
trackingId: ccconfig_af9eecc5-0472-4549-9a83-2afdae0d4ba0
error:
key: '403'
reason: Test reason
message:
- description: Test error
code: '403'
entity: cc_user
references: []
'409':
description: Similar entity is already present
content:
application/json:
schema:
$ref: '#/components/schemas/ApiErrorResponse'
example:
trackingId: ccconfig_af9eecc5-0472-4549-9a83-2afdae0d4ba0
error:
key: '409'
reason: Test reason
message:
- description: Test error
code: '409'
entity: cc_user
references: []
'429':
description: Too many requests have been sent in a given amount of time and the request has been rate limited
content:
application/json:
schema:
$ref: '#/components/schemas/ApiErrorResponse'
example:
trackingId: ccconfig_af9eecc5-0472-4549-9a83-2afdae0d4ba0
error:
key: '429'
reason: Test reason
message:
- description: Test error
code: '429'
entity: cc_user
references: []
'500':
description: An Unexpected Error Occurred
content:
application/json:
schema:
$ref: '#/components/schemas/ApiErrorResponse'
example:
trackingId: ccconfig_af9eecc5-0472-4549-9a83-2afdae0d4ba0
error:
key: '500'
reason: Test reason
message:
- description: Test error
code: '500'
entity: cc_user
references: []
deprecated: false
delete:
tags:
- Dial Number
summary: Delete all Dialed Number Mapping(s)
description: Delete all Dialed Number Mapping(s) in a given organization.
operationId: deleteAllConfig
parameters:
- name: orgid
in: path
description: Organization ID to be used for this operation. The specified security token must have permission to interact with the organization.
required: true
schema:
type: string
example: 2f9eecc5-0472-4549-9a83-2afdae0d4ba1
responses:
'200':
description: OK
'401':
description: Unauthorized Operation
content:
application/json:
schema:
$ref: '#/components/schemas/ApiErrorResponse'
example:
trackingId: ccconfig_af9eecc5-0472-4549-9a83-2afdae0d4ba0
error:
key: '401'
reason: Test reason
message:
- description: Test error
code: '401'
entity: cc_user
references: []
'403':
description: Operation is forbidden
content:
application/json:
schema:
$ref: '#/components/schemas/ApiErrorResponse'
example:
trackingId: ccconfig_af9eecc5-0472-4549-9a83-2afdae0d4ba0
error:
key: '403'
reason: Test reason
message:
- description: Test error
code: '403'
entity: cc_user
references: []
'404':
description: Resource not found or URI is invalid
content:
application/json:
schema:
$ref: '#/components/schemas/ApiErrorResponse'
example:
trackingId: ccconfig_af9eecc5-0472-4549-9a83-2afdae0d4ba0
error:
key: '404'
reason: Test reason
message:
- description: Test error
code: '404'
entity: cc_user
references: []
'412':
description: Resource referred in other entity(s). Please get all the reference entities info by invoking Get incoming-references api.
content:
application/json:
schema:
$ref: '#/components/schemas/ApiErrorResponse'
example:
trackingId: ccconfig_af9eecc5-0472-4549-9a83-2afdae0d4ba0
error:
key: '412'
reason: Test reason
message:
- description: Test error
code: '412'
entity: cc_user
references: []
'429':
description: Too many requests have been sent in a given amount of time and the request has been rate limited
content:
application/json:
schema:
$ref: '#/components/schemas/ApiErrorResponse'
example:
trackingId: ccconfig_af9eecc5-0472-4549-9a83-2afdae0d4ba0
error:
key: '429'
reason: Test reason
message:
- description: Test error
code: '429'
entity: cc_user
references: []
'500':
description: An Unexpected Error Occurred
content:
application/json:
schema:
$ref: '#/components/schemas/ApiErrorResponse'
example:
trackingId: ccconfig_af9eecc5-0472-4549-9a83-2afdae0d4ba0
error:
key: '500'
reason: Test reason
message:
- description: Test error
code: '500'
entity: cc_user
references: []
deprecated: false
/organization/{orgid}/dial-number/bulk:
post:
tags:
- Dial Number
summary: Bulk save Dialed Number Mapping(s)
description: Create, Update or delete Dialed Number Mapping(s) in bulk in a given organization.
operationId: saveAllConfig_14
parameters:
- name: orgid
in: path
description: Organization ID to be used for this operation. The specified security token must have permission to interact with the organization.
required: true
schema:
type: string
example: 2f9eecc5-0472-4549-9a83-2afdae0d4ba1
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/BulkRequestDTODialledNumberEntryPointDTO'
required: true
responses:
'207':
description: Multi-Status
content:
'*/*':
schema:
$ref: '#/components/schemas/BulkResponseDTO'
'400':
description: The request was invalid and cannot be served. An accompanying error message will explain further
content:
application/json:
schema:
$ref: '#/components/schemas/ApiErrorResponse'
example:
trackingId: ccconfig_af9eecc5-0472-4549-9a83-2afdae0d4ba0
error:
key: '400'
reason: Test reason
message:
- description: Test error
code: '400'
entity: cc_user
references: []
'401':
description: Unauthorized Operation
content:
application/json:
schema:
$ref: '#/components/schemas/ApiErrorResponse'
example:
trackingId: ccconfig_af9eecc5-0472-4549-9a83-2afdae0d4ba0
error:
key: '401'
reason: Test reason
message:
- description: Test error
code: '401'
entity: cc_user
references: []
'403':
description: Operation is forbidden
content:
application/json:
schema:
$ref: '#/components/schemas/ApiErrorResponse'
example:
trackingId: ccconfig_af9eecc5-0472-4549-9a83-2afdae0d4ba0
error:
key: '403'
reason: Test reason
message:
- description: Test error
code: '403'
entity: cc_user
references: []
'409':
description: Similar entity is already present
content:
application/json:
schema:
$ref: '#/components/schemas/ApiErrorResponse'
example:
trackingId: ccconfig_af9eecc5-0472-4549-9a83-2afdae0d4ba0
error:
key: '409'
reason: Test reason
message:
- description: Test error
code: '409'
entity: cc_user
references: []
'429':
description: Too many requests have been sent in a given amount of time and the request has been rate limited
content:
application/json:
schema:
$ref: '#/components/schemas/ApiErrorResponse'
example:
trackingId: ccconfig_af9eecc5-0472-4549-9a83-2afdae0d4ba0
error:
key: '429'
reason: Test reason
message:
- description: Test error
code: '429'
entity: cc_user
references: []
'500':
description: An Unexpected Error Occurred
content:
application/json:
schema:
$ref: '#/components/schemas/ApiErrorResponse'
example:
trackingId: ccconfig_af9eecc5-0472-4549-9a83-2afdae0d4ba0
error:
key: '500'
reason: Test reason
message:
- description: Test error
code: '500'
entity: cc_user
references: []
deprecated: false
/organization/{orgid}/dial-number/bulk-export:
get:
tags:
- Dial Number
summary: Bulk export Dialed Number Mapping(s)
description: Export all Dialed Number Mapping(s) in a given organization.
operationId: bulkExport_12
parameters:
- name: orgid
in: path
description: Organization ID to be used for this operation. The specified security token must have permission to interact with the organization.
required: true
schema:
type: string
example: 2f9eecc5-0472-4549-9a83-2afdae0d4ba1
- name: page
in: query
description: Defines the number of displayed page. The page number starts from 0.
schema:
type: integer
default: 0
example: 0
example: 0
- name: pageSize
in: query
description: Defines the number of items to be displayed on a page. If the number specified is more than allowed max page size, the API will automatically adjust the page size to the max page size.
schema:
type: integer
default: 100
example: 100
example: 100
responses:
'200':
description: OK
content:
'*/*':
schema:
$ref: '#/components/schemas/BulkExportDTODialledNumberEntryPointExportDTO'
'401':
description: Unauthorized Operation
content:
application/json:
schema:
$ref: '#/components/schemas/ApiErrorResponse'
example:
trackingId: ccconfig_af9eecc5-0472-4549-9a83-2afdae0d4ba0
error:
key: '401'
reason: Test reason
message:
- description: Test error
code: '401'
entity: cc_user
references: []
'403':
description: Operation is forbidden
content:
application/json:
schema:
$ref: '#/components/schemas/ApiErrorResponse'
example:
trackingId: ccconfig_af9eecc5-0472-4549-9a83-2afdae0d4ba0
error:
key: '403'
reason: Test reason
message:
- description: Test error
code: '403'
entity: cc_user
references: []
'404':
description: Resource not found or URI is invalid
content:
application/json:
schema:
$ref: '#/components/schemas/ApiErrorResponse'
example:
trackingId: ccconfig_af9eecc5-0472-4549-9a83-2afdae0d4ba0
error:
key: '404'
reason: Test reason
message:
- description: Test error
code: '404'
entity: cc_user
references: []
'429':
description: Too many requests have been sent in a given amount of time and the request has been rate limited
content:
application/json:
schema:
$ref: '#/components/schemas/ApiErrorResponse'
example:
trackingId: ccconfig_af9eecc5-0472-4549-9a83-2afdae0d4ba0
error:
key: '429'
reason: Test reason
message:
- description: Test error
code: '429'
entity: cc_user
references: []
'500':
description: An Unexpected Error Occurred
content:
application/json:
schema:
$ref: '#/components/schemas/ApiErrorResponse'
example:
trackingId: ccconfig_af9eecc5-0472-4549-9a83-2afdae0d4ba0
error:
key: '500'
reason: Test reason
message:
- description: Test error
code: '500'
entity: cc_user
references: []
deprecated: true
/organization/{orgid}/dial-number/numbers-only:
get:
tags:
- Dial Number
summary: List only dialed numbers(property - dialledNumber) from Dialed Number Mapping(s)
description: Retrieve a list of only dialed numbers(property - dialledNumber) from Dialed Number Mapping(s) without pagination in a given organization.
operationId: getDNsbyOrgID
parameters:
- name: orgid
in: path
description: Organization ID to be used for this operation. The specified security token must have permission to interact with the organization.
required: true
schema:
type: string
example: 2f9eecc5-0472-4549-9a83-2afdae0d4ba1
responses:
'200':
description: OK
content:
'*/*':
schema:
type: array
items:
type: string
'401':
description: Unauthorized Operation
content:
application/json:
schema:
$ref: '#/components/schemas/ApiErrorResponse'
example:
trackingId: ccconfig_af9eecc5-0472-4549-9a83-2afdae0d4ba0
error:
key: '401'
reason: Test reason
message:
- description: Test error
code: '401'
entity: cc_user
references: []
'403':
description: Operation is forbidden
content:
application/json:
schema:
$ref: '#/components/schemas/ApiErrorResponse'
example:
trackingId: ccconfig_af9eecc5-0472-4549-9a83-2afdae0d4ba0
error:
key: '403'
reason: Test reason
message:
- description: Test error
code: '403'
entity: cc_user
references: []
'404':
description: Resource not found or URI is invalid
content:
application/json:
schema:
$ref: '#/components/schemas/ApiErrorResponse'
example:
trackingId: ccconfig_af9eecc5-0472-4549-9a83-2afdae0d4ba0
error:
key: '404'
reason: Test reason
message:
- description: Test error
code: '404'
entity: cc_user
references: []
'429':
description: Too many requests have been sent in a given amount of time and the request has been rate limited
content:
application/json:
schema:
$ref: '#/components/schemas/ApiErrorResponse'
example:
trackingId: ccconfig_af9eecc5-0472-4549-9a83-2afdae0d4ba0
error:
key: '429'
reason: Test reason
message:
- description: Test error
code: '429'
entity: cc_user
references: []
'500':
description: An Unexpected Error Occurred
content:
application/json:
schema:
$ref: '#/components/schemas/ApiErrorResponse'
example:
trackingId: ccconfig_af9eecc5-0472-4549-9a83-2afdae0d4ba0
error:
key: '500'
reason: Test reason
message:
- description: Test error
code: '500'
entity: cc_user
references: []
deprecated: false
/organization/{orgid}/dial-number/{id}:
get:
tags:
- Dial Number
summary: Get specific Dialed Number Mapping by ID
description: Retrieve an existing Dialed Number Mapping by ID in a given organization.
operationId: getConfig_16
parameters:
- name: orgid
in: path
description: Organization ID to be used for this operation. The specified security token must have permission to interact with the organization.
required: true
schema:
type: string
example: 2f9eecc5-0472-4549-9a83-2afdae0d4ba1
- name: id
in: path
description: Resource ID of the Dialed Number Mapping.
required: true
schema:
type: string
example: 2f9eecc5-0472-4549-9a83-2afdae0d4ba2
responses:
'200':
description: OK
content:
'*/*':
schema:
$ref: '#/components/schemas/DialledNumberEntryPointDTO'
'401':
description: Unauthorized Operation
content:
application/json:
schema:
$ref: '#/components/schemas/ApiErrorResponse'
example:
trackingId: ccconfig_af9eecc5-0472-4549-9a83-2afdae0d4ba0
error:
key: '401'
reason: Test reason
message:
- description: Test error
code: '401'
entity: cc_user
references: []
'403':
description: Operation is forbidden
content:
application/json:
schema:
$ref: '#/components/schemas/ApiErrorResponse'
example:
trackingId: ccconfig_af9eecc5-0472-4549-9a83-2afdae0d4ba0
error:
key: '403'
reason: Test reason
message:
- description: Test error
code: '403'
entity: cc_user
references: []
'404':
description: Resource not found or URI is invalid
content:
application/json:
schema:
$ref: '#/components/schemas/ApiErrorResponse'
example:
trackingId: ccconfig_af9eecc5-0472-4549-9a83-2afdae0d4ba0
error:
key: '404'
reason: Test reason
message:
- description: Test error
code: '404'
entity: cc_user
references: []
'429':
description: Too many requests have been sent in a given amount of time and the request has been rate limited
content:
application/json:
schema:
$ref: '#/components/schemas/ApiErrorResponse'
example:
trackingId: ccconfig_af9eecc5-0472-4549-9a83-2afdae0d4ba0
error:
key: '429'
reason: Test reason
message:
- description: Test error
code: '429'
entity: cc_user
references: []
'500':
description: An Unexpected Error Occurred
content:
application/json:
schema:
$ref: '#/components/schemas/ApiErrorResponse'
example:
trackingId: ccconfig_af9eecc5-0472-4549-9a83-2afdae0d4ba0
error:
key: '500'
reason: Test reason
message:
- description: Test error
code: '500'
entity: cc_user
references: []
deprecated: false
put:
tags:
- Dial Number
summary: Update specific Dialed Number Mapping by ID
description: Update an existing Dialed Number Mapping by ID in a given organization.
operationId: updateConfig_16
parameters:
- name: orgid
in: path
description: Organization ID to be used for this operation. The specified security token must have permission to interact with the organization.
required: true
schema:
type: string
example: 2f9eecc5-0472-4549-9a83-2afdae0d4ba1
- name: id
in: path
description: Resource ID of the Dialed Number Mapping.
required: true
schema:
type: string
example: 2f9eecc5-0472-4549-9a83-2afdae0d4ba2
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/DialledNumberEntryPointDTO'
required: true
responses:
'200':
description: OK
content:
'*/*':
schema:
$ref: '#/components/schemas/DialledNumberEntryPointDTO'
'400':
description: The request was invalid and cannot be served. An accompanying error message will explain further
content:
application/json:
schema:
$ref: '#/components/schemas/ApiErrorResponse'
example:
trackingId: ccconfig_af9eecc5-0472-4549-9a83-2afdae0d4ba0
error:
key: '400'
reason: Test reason
message:
- description: Test error
code: '400'
entity: cc_user
references: []
'401':
description: Unauthorized Operation
content:
application/json:
schema:
$ref: '#/components/schemas/ApiErrorResponse'
example:
trackingId: ccconfig_af9eecc5-0472-4549-9a83-2afdae0d4ba0
error:
key: '401'
reason: Test reason
message:
- description: Test error
code: '401'
entity: cc_user
references: []
'403':
description: Operation is forbidden
content:
application/json:
schema:
$ref: '#/components/schemas/ApiErrorResponse'
example:
trackingId: ccconfig_af9eecc5-0472-4549-9a83-2afdae0d4ba0
error:
key: '403'
reason: Test reason
message:
- description: Test error
code: '403'
entity: cc_user
references: []
'404':
description: Resource not found or URI is invalid
content:
application/json:
schema:
$ref: '#/components/schemas/ApiErrorResponse'
example:
trackingId: ccconfig_af9eecc5-0472-4549-9a83-2afdae0d4ba0
error:
key: '404'
reason: Test reason
message:
- description: Test error
code: '404'
entity: cc_user
references: []
'412':
description: Resource referred in other entity(s). Please get all the reference entities info by invoking Get incoming-references api.
content:
application/json:
schema:
$ref: '#/components/schemas/ApiErrorResponse'
example:
trackingId: ccconfig_af9eecc5-0472-4549-9a83-2afdae0d4ba0
error:
key: '412'
reason: Test reason
message:
- description: Test error
code: '412'
entity: cc_user
references: []
'429':
description: Too many requests have been sent in a given amount of time and the request has been rate limited
content:
application/json:
schema:
$ref: '#/components/schemas/ApiErrorResponse'
example:
trackingId: ccconfig_af9eecc5-0472-4549-9a83-2afdae0d4ba0
error:
key: '429'
reason: Test reason
message:
- description: Test error
code: '429'
entity: cc_user
references: []
'500':
description: An Unexpected Error Occurred
content:
application/json:
schema:
$ref: '#/components/schemas/ApiErrorResponse'
example:
trackingId: ccconfig_af9eecc5-0472-4549-9a83-2afdae0d4ba0
error:
key: '500'
reason: Test reason
message:
- description: Test error
code: '500'
entity: cc_user
references: []
deprecated: false
delete:
tags:
- Dial Number
summary: Delete specific Dialed Number Mapping by ID
description: Delete an existing Dialed Number Mapping by ID in a given organization.
operationId: deleteConfig_14
parameters:
- name: orgid
in: path
description: Organization ID to be used for this operation. The specified security token must have permission to interact with the organization.
required: true
schema:
type: string
example: 2f9eecc5-0472-4549-9a83-2afdae0d4ba1
- name: id
in: path
description: Resource ID of the Dialed Number Mapping.
required: true
schema:
type: string
example: 2f9eecc5-0472-4549-9a83-2afdae0d4ba2
responses:
'200':
description: OK
'401':
description: Unauthorized Operation
content:
application/json:
schema:
$ref: '#/components/schemas/ApiErrorResponse'
example:
trackingId: ccconfig_af9eecc5-0472-4549-9a83-2afdae0d4ba0
error:
key: '401'
reason: Test reason
message:
- description: Test error
code: '401'
entity: cc_user
references: []
'403':
description: Operation is forbidden
content:
application/json:
schema:
$ref: '#/components/schemas/ApiErrorResponse'
example:
trackingId: ccconfig_af9eecc5-0472-4549-9a83-2afdae0d4ba0
error:
key: '403'
reason: Test reason
message:
- description: Test error
code: '403'
entity: cc_user
references: []
'404':
description: Resource not found or URI is invalid
content:
application/json:
schema:
$ref: '#/components/schemas/ApiErrorResponse'
example:
trackingId: ccconfig_af9eecc5-0472-4549-9a83-2afdae0d4ba0
error:
key: '404'
reason: Test reason
message:
- description: Test error
code: '404'
entity: cc_user
references: []
'412':
description: Resource referred in other entity(s). Please get all the reference entities info by invoking Get incoming-references api.
content:
application/json:
schema:
$ref: '#/components/schemas/ApiErrorResponse'
example:
trackingId: ccconfig_af9eecc5-0472-4549-9a83-2afdae0d4ba0
error:
key: '412'
reason: Test reason
message:
- description: Test error
code: '412'
entity: cc_user
references: []
'429':
description: Too many requests have been sent in a given amount of time and the request has been rate limited
content:
application/json:
schema:
$ref: '#/components/schemas/ApiErrorResponse'
example:
trackingId: ccconfig_af9eecc5-0472-4549-9a83-2afdae0d4ba0
error:
key: '429'
reason: Test reason
message:
- description: Test error
code: '429'
entity: cc_user
references: []
'500':
description: An Unexpected Error Occurred
content:
application/json:
schema:
$ref: '#/components/schemas/ApiErrorResponse'
example:
trackingId: ccconfig_af9eecc5-0472-4549-9a83-2afdae0d4ba0
error:
key: '500'
reason: Test reason
message:
- description: Test error
code: '500'
entity: cc_user
references: []
deprecated: false
/organization/{orgid}/dial-number/{id}/incoming-references:
get:
tags:
- Dial Number
summary: List references for a specific Dialed Number Mapping
description: Retrieve a list of all entities that have reference to an existing Dialed Number Mapping by ID in a given organization.
operationId: getIncomingReferences_12
parameters:
- name: orgid
in: path
description: Organization ID to be used for this operation. The specified security token must have permission to interact with the organization.
required: true
schema:
type: string
example: 2f9eecc5-0472-4549-9a83-2afdae0d4ba1
- name: id
in: path
description: ID of this contact center resource.
required: true
schema:
type: string
example: af9eecc5-0472-4549-9a83-2afdae0d4ba0
- name: type
in: query
description: Entity type of the other entity that has a reference to this specific entity.
required: false
schema:
type: string
example: type_text
- name: page
in: query
description: Defines the number of displayed page. The page number starts from 0.
schema:
type: integer
default: 0
example: 0
example: 0
- name: pageSize
in: query
description: Defines the number of items to be displayed on a page. If the number specified is more than allowed max page size, the API will automatically adjust the page size to the max page size.
schema:
type: integer
default: 100
example: 100
example: 100
responses:
'200':
description: OK
content:
'*/*':
schema:
$ref: '#/components/schemas/EntityReferenceInfoDTO'
'401':
description: Unauthorized Operation
content:
application/json:
schema:
$ref: '#/components/schemas/ApiErrorResponse'
example:
trackingId: ccconfig_af9eecc5-0472-4549-9a83-2afdae0d4ba0
error:
key: '401'
reason: Test reason
message:
- description: Test error
code: '401'
entity: cc_user
references: []
'403':
description: Operation is forbidden
content:
application/json:
schema:
$ref: '#/components/schemas/ApiErrorResponse'
example:
trackingId: ccconfig_af9eecc5-0472-4549-9a83-2afdae0d4ba0
error:
key: '403'
reason: Test reason
message:
- description: Test error
code: '403'
entity: cc_user
references: []
'404':
description: Resource not found or URI is invalid
content:
application/json:
schema:
$ref: '#/components/schemas/ApiErrorResponse'
example:
trackingId: ccconfig_af9eecc5-0472-4549-9a83-2afdae0d4ba0
error:
key: '404'
reason: Test reason
message:
- description: Test error
code: '404'
entity: cc_user
references: []
'429':
description: Too many requests have been sent in a given amount of time and the request has been rate limited
content:
application/json:
schema:
$ref: '#/components/schemas/ApiErrorResponse'
example:
trackingId: ccconfig_af9eecc5-0472-4549-9a83-2afdae0d4ba0
error:
key: '429'
reason: Test reason
message:
- description: Test error
code: '429'
entity: cc_user
references: []
'500':
description: An Unexpected Error Occurred
content:
application/json:
schema:
$ref: '#/components/schemas/ApiErrorResponse'
example:
trackingId: ccconfig_af9eecc5-0472-4549-9a83-2afdae0d4ba0
error:
key: '500'
reason: Test reason
message:
- description: Test error
code: '500'
entity: cc_user
references: []
deprecated: false
/organization/{orgid}/v2/dial-number:
get:
tags:
- Dial Number
summary: List Dialed Number Mapping(s)
description: Retrieve a list of Dialed Number Mapping(s) in a given organization.
operationId: getAllConfigWithMetaData_15
parameters:
- name: orgid
in: path
description: Organization ID to be used for this operation. The specified security token must have permission to interact with the organization.
required: true
schema:
type: string
example: 2f9eecc5-0472-4549-9a83-2afdae0d4ba1
- name: filter
in: query
description: "Specify a filter based on which the results will be fetched. All the fields are supported except: organizationId, createdTime, lastUpdatedTime \n\nThe examples below show some search queries\n- id==\"57efb0e6-5af0-4245-a67d-d3c5045cdb6e\"\n- id!=\"57efb0e6-5af0-4245-a67d-d3c5045cdb6e\"\n- id=in=(\"57efb0e6-5af0-4245-a67d-d3c5045cdb6e\",\"a421e0b2-732e-46f3-a057-39160a53afb9\")\n- id=out=(\"57efb0e6-5af0-4245-a67d-d3c5045cdb6e\",\"a421e0b2-732e-46f3-a057-39160a53afb9\")\nThis parameter uses the RSQL query syntax, a URI-friendly format for expressing criteria for filtering REST entities. For more information about RSQL in general, see this reference. For a list of supported operators, see this syntax guide.\n\nNote: values to be used in the filter syntax should not contain spaces. If they do, please enclose them in quotes to apply the filter.\n"
required: false
schema:
type: string
example: id=="2f9eecc5-0472-4549-9a83-2afdae0d4ba1"
- name: attributes
in: query
description: Specify the attributes to be returned. By default, all attributes are returned along with the specified columns. All attributes are supported. except (links)
required: false
schema:
type: string
format: string
example: id
- name: search
in: query
description: 'Filter data based on the search keyword.Supported search columns(dialledNumber)
The examples below show some search queries
- "Cisco"
- field=="dialledNumber";value=="Cisco"
- fields=in=("dialledNumber");value=="Cisco"
'
required: false
schema:
type: string
example: contact center
- name: page
in: query
description: Defines the number of displayed page. The page number starts from 0.
schema:
type: integer
default: 0
example: 0
example: 0
- name: pageSize
in: query
description: Defines the number of items to be displayed on a page. If the number specified is more than allowed max page size, the API will automatically adjust the page size to the max page size.
schema:
type: integer
default: 100
example: 100
example: 100
- name: includeEntryPointName
in: query
description: If includeEntryPointName is set to true and entryPointName is in the attributes, the API will return entryPointName in the Get All response, and filtering, searching, and sorting on entryPointName will also be enabled.
schema:
type: boolean
default: false
example: false
responses:
'200':
description: OK
content:
'*/*':
schema:
$ref: '#/components/schemas/ResponseEnvelopeDialledNumberEntryPointDTO'
'401':
description: Unauthorized Operation
content:
application/json:
schema:
$ref: '#/components/schemas/ApiErrorResponse'
example:
trackingId: ccconfig_af9eecc5-0472-4549-9a83-2afdae0d4ba0
error:
key: '401'
reason: Test reason
message:
- description: Test error
code: '401'
entity: cc_user
references: []
'403':
description: Operation is forbidden
content:
application/json:
schema:
$ref: '#/components/schemas/ApiErrorResponse'
example:
trackingId: ccconfig_af9eecc5-0472-4549-9a83-2afdae0d4ba0
error:
key: '403'
reason: Test reason
message:
- description: Test error
code: '403'
entity: cc_user
references: []
'404':
description: Resource not found or URI is invalid
content:
application/json:
schema:
$ref: '#/components/schemas/ApiErrorResponse'
example:
trackingId: ccconfig_af9eecc5-0472-4549-9a83-2afdae0d4ba0
error:
key: '404'
reason: Test reason
message:
- description: Test error
code: '404'
entity: cc_user
references: []
'429':
description: Too many requests have been sent in a given amount of time and the request has been rate limited
content:
application/json:
schema:
$ref: '#/components/schemas/ApiErrorResponse'
example:
trackingId: ccconfig_af9eecc5-0472-4549-9a83-2afdae0d4ba0
error:
key: '429'
reason: Test reason
message:
- description: Test error
code: '429'
entity: cc_user
references: []
'500':
description: An Unexpected Error Occurred
content:
application/json:
schema:
$ref: '#/components/schemas/ApiErrorResponse'
example:
trackingId: ccconfig_af9eecc5-0472-4549-9a83-2afdae0d4ba0
error:
key: '500'
reason: Test reason
message:
- description: Test error
code: '500'
entity: cc_user
references: []
deprecated: false
/organization/{orgid}/v3/dial-number:
get:
tags:
- Dial Number
summary: List Dialed Number Mapping(s)
description: Retrieve a list of Dialed Number Mapping(s) in a given organization.
operationId: getAllConfigWithMetaDataV3
parameters:
- name: orgid
in: path
description: Organization ID to be used for this operation. The specified security token must have permission to interact with the organization.
required: true
schema:
type: string
example: 2f9eecc5-0472-4549-9a83-2afdae0d4ba1
- name: filter
in: query
description: "Specify a filter based on which the results will be fetched. All the fields are supported except: organizationId, createdTime, lastUpdatedTime \n\nThe examples below show some search queries\n- id==\"57efb0e6-5af0-4245-a67d-d3c5045cdb6e\"\n- id!=\"57efb0e6-5af0-4245-a67d-d3c5045cdb6e\"\n- id=in=(\"57efb0e6-5af0-4245-a67d-d3c5045cdb6e\",\"a421e0b2-732e-46f3-a057-39160a53afb9\")\n- id=out=(\"57efb0e6-5af0-4245-a67d-d3c5045cdb6e\",\"a421e0b2-732e-46f3-a057-39160a53afb9\")\nThis parameter uses the RSQL query syntax, a URI-friendly format for expressing criteria for filtering REST entities. For more information about RSQL in general, see this reference. For a list of supported operators, see this syntax guide.\n\nNote: values to be used in the filter syntax should not contain spaces. If they do, please enclose them in quotes to apply the filter.\n"
required: false
schema:
type: string
example: id=="2f9eecc5-0472-4549-9a83-2afdae0d4ba1"
- name: attributes
in: query
description: Specify the attributes to be returned. By default, all attributes are returned along with the specified columns. All attributes are supported. except (links)
required: false
schema:
type: string
format: string
example: id
- name: search
in: query
description: 'Filter data based on the search keyword.Supported search columns(dialledNumber)
The examples below show some search queries
- "Cisco"
- field=="dialledNumber";value=="Cisco"
- fields=in=("dialledNumber");value=="Cisco"
'
required: false
schema:
type: string
example: contact center
- name: page
in: query
description: Defines the number of displayed page. The page number starts from 0.
schema:
type: integer
default: 0
example: 0
example: 0
- name: pageSize
in: query
description: Defines the number of items to be displayed on a page. If the number specified is more than allowed max page size, the API will automatically adjust the page size to the max page size.
schema:
type: integer
default: 100
example: 100
example: 100
- name: includeEntryPointName
in: query
description: If includeEntryPointName is set to true and entryPointName is in the attributes, the API will return entryPointName in the Get All response, and filtering, searching, and sorting on entryPointName will also be enabled.
schema:
type: boolean
default: false
example: false
responses:
'200':
description: OK
content:
'*/*':
schema:
$ref: '#/components/schemas/ResponseEnvelopeDialledNumberEntryPointDTO'
'401':
description: Unauthorized Operation
content:
application/json:
schema:
$ref: '#/components/schemas/ApiErrorResponse'
example:
trackingId: ccconfig_af9eecc5-0472-4549-9a83-2afdae0d4ba0
error:
key: '401'
reason: Test reason
message:
- description: Test error
code: '401'
entity: cc_user
references: []
'403':
description: Operation is forbidden
content:
application/json:
schema:
$ref: '#/components/schemas/ApiErrorResponse'
example:
trackingId: ccconfig_af9eecc5-0472-4549-9a83-2afdae0d4ba0
error:
key: '403'
reason: Test reason
message:
- description: Test error
code: '403'
entity: cc_user
references: []
'404':
description: Resource not found or URI is invalid
content:
application/json:
schema:
$ref: '#/components/schemas/ApiErrorResponse'
example:
trackingId: ccconfig_af9eecc5-0472-4549-9a83-2afdae0d4ba0
error:
key: '404'
reason: Test reason
message:
- description: Test error
code: '404'
entity: cc_user
references: []
'429':
description: Too many requests have been sent in a given amount of time and the request has been rate limited
content:
application/json:
schema:
$ref: '#/components/schemas/ApiErrorResponse'
example:
trackingId: ccconfig_af9eecc5-0472-4549-9a83-2afdae0d4ba0
error:
key: '429'
reason: Test reason
message:
- description: Test error
code: '429'
entity: cc_user
references: []
'500':
description: An Unexpected Error Occurred
content:
application/json:
schema:
$ref: '#/components/schemas/ApiErrorResponse'
example:
trackingId: ccconfig_af9eecc5-0472-4549-9a83-2afdae0d4ba0
error:
key: '500'
reason: Test reason
message:
- description: Test error
code: '500'
entity: cc_user
references: []
deprecated: false
components:
schemas:
ApiErrorResponse:
description: Response body for an API error.
type: object
properties:
trackingId:
type: string
description: "An opaque identifier for mapping protocol failures to service internal codes. \n\nWhen specified in a request, it can be used for co-relating events across services"
example: c1a4fcef-aee2-4dea-8977-29f594760552
error:
description: An object containing details about the error.
$ref: '#/components/schemas/ErrorDetails'
ResponseEnvelopeDialledNumberEntryPointDTO:
type: object
properties:
meta:
type: object
additionalProperties: {}
data:
type: array
items:
$ref: '#/components/schemas/DialledNumberEntryPointDTO'
ErrorDetails:
description: Details of an error.
type: object
properties:
key:
type: string
description: An application defined error code.
example: '401'
message:
type: array
description: A message providing details about the error.
items:
$ref: '#/components/schemas/OperationError'
BulkResponseItemDTO:
type: object
properties:
itemIdentifier:
type: integer
description: Unique item identifier for a bulk operation.
format: int32
example: 10
status:
type: integer
description: Indicates the error status code.
format: int32
example: 400
operationType:
type: string
description: The kind of operation desired of an entity.
example: CREATE
enum:
- CREATE
- UPDATE
- DELETE
- GET
href:
type: string
description: The resource URI of an entity.
example: /api/organization/6705c69d-4585-42ad-bfc3-79cc485dfb15/team/7b26d174-0016-4682-9858-65918e05f85
apiError:
$ref: '#/components/schemas/ApiErrorResponse'
example:
apiError:
error:
key: '400'
message:
- description: 'siteId: not found for given orgId.'
entity: string
references:
- id: string
name: string
reason: dependency exists
trackingId: ccconfig_c1a4fcef-aee2-4dea-8977-29f594760552
href: /api/organization/6705c69d-4585-42ad-bfc3-79cc485dfb15/team/7b26d174-0016-4682-9858-65918e05f85
itemIdentifier: 10
operationType: CREATE
status: 400
DialledNumberEntryPointExportDTO:
type: object
properties:
dialledNumber:
type: string
extension:
type: string
location:
type: string
entryPointName:
type: string
region:
type: string
OperationError:
description: An error message providing details about the operation failure.
type: object
properties:
description:
type: string
description: A human readable explanation for the occurrence of an error.
example: Incorrect Credentials.
BulkRequestDTODialledNumberEntryPointDTO:
type: object
properties:
items:
type: array
description: List of items in the bulk request.
items:
$ref: '#/components/schemas/BulkRequestItemDTODialledNumberEntryPointDTO'
BulkRequestItemDTODialledNumberEntryPointDTO:
type: object
description: List of items in the bulk request.
properties:
itemIdentifier:
type: integer
format: int32
description: Unique item identifier for a bulk operation.
example: 10
item:
$ref: '#/components/schemas/DialledNumberEntryPointDTO'
requestAction:
type: string
description: Identifier for action type. Possible values are `SAVE` and `DELETE`.
example: SAVE
BulkResponseDTO:
type: object
properties:
items:
type: array
items:
$ref: '#/components/schemas/BulkResponseItemDTO'
DialledNumberEntryPointDTO:
type: object
properties:
organizationId:
type: string
format: uuid
description: ID of the contact center organization. This field is required for all bulk save operations.
example: f53c8b54-46ca-43f6-ba05-08426a46e23d
maxLength: 36
minLength: 32
pattern: ^[0-9a-fA-F]{8}-?[0-9a-fA-F]{4}-?[0-9a-fA-F]{4}-?[0-9a-fA-F]{4}-?[0-9a-fA-F]{12}$
id:
type: string
description: ID of this contact center resource. It should not be specified when creating a new resource. However, it is mandatory when updating a resource.
example: 93912f11-6017-404b-bf14-5331890b1797
version:
type: integer
format: int32
description: The version of this resource. For a newly created resource, it will be 0 unless specified otherwise.
example: 1
dialledNumber:
type: string
description: The dialed number(DN) used to map to entry points.
example: +1-1234567890
maxLength: 20
minLength: 0
pattern: ^\+{0,1}\d+[\d.\-]*$
extension:
type: string
description: The extension used to map to entry points.
example: 1234
maxLength: 10
minLength: 0
pattern: ^\d{2,10}$
routingPrefix:
type: string
description: The routing prefix is mapped to a location and can be prefixed with an extension
example: 91
maxLength: 7
minLength: 0
pattern: ^\d{2,7}$
esn:
type: string
description: The esn is routing prefix with extension
example: 919876
maxLength: 17
minLength: 0
pattern: ^\d{2,17}$
routePointId:
type: string
description: The identifier of a route point of WxC which is similar to entry point of WxCC
example: 7cbd4aad-0c3b-4de4-a15a-33cf05b9bf8j
entryPointId:
type: string
description: The identifier of an entry point to which you want to map the DN.
example: 7cbd4aad-0c3b-4de4-a15a-33cf05b9bf8j
entryPointName:
type: string
description: The entryPoint name of the entryPointId.
example: Entry-Point
defaultAni:
type: boolean
description: 'The default dial number for the tenant to make outdial calls. The default dial number is displayed in the customer''s caller ID, if an agent does not select a specific outdial ANI (Automatic Number Identification) for an outdial call.
A default value is automatically set once and entry point mapping is created'
example: true
location:
type: string
description: The name of the location as configured on Webex Calling(applicable only for Webex Calling).
example: 7cbd4aad-0c3b-4de4-a15a-33cf05b9bf8j
regionId:
type: string
description: 'Specify the telephony region id.
You can pass id for one of these regions:
US (USA), CA (Canada), MX (Mexico), AU (Australia), SG (Singapore), GB (United Kingdom), DE (Germany)
You can retrieve it by calling /api/global/telephony-region API.'
example: 7cbd4aad-0c3b-4de4-a15a-33cf05b9bf8j
createdTime:
type: integer
format: int64
description: This is the created time of the entity.
lastUpdatedTime:
type: integer
format: int64
description: This is the updated time of the entity.
dialledNumberDigits:
type: string
required:
- entryPointId
- entryPointName
BulkExportDTODialledNumberEntryPointExportDTO:
type: object
description: Bulk export Dto
example:
totalResources: 100
pageNumber: 0
pageSize: 50
rel: last
resources: []
properties:
totalResources:
type: integer
format: int32
description: Total number of items.
example: 100
pageNumber:
type: integer
format: int32
description: Current page number.
example: 0
pageSize:
type: integer
format: int32
description: Page size for current data set.
example: 50
rel:
type: string
description: Indicates whether more pages exist. When 'next' there are more pages available, otherwise 'last'.
example: last
resources:
type: array
description: Indicate the page resources
items:
$ref: '#/components/schemas/DialledNumberEntryPointExportDTO'
MetaDataReferencesPagingInfo:
title: MetaDataReferencesPagingInfo
type: object
properties:
orgid:
maxLength: 36
minLength: 32
pattern: ^[0-9a-fA-F]{8}-?[0-9a-fA-F]{4}-?[0-9a-fA-F]{4}-?[0-9a-fA-F]{4}-?[0-9a-fA-F]{12}$
type: string
description: Org ID
format: uuid
example: 2f9eecc5-0472-4549-9a83-2afdae0d4ba1
page:
type: integer
description: Current page number
format: int32
example: 1
pageSize:
type: integer
description: Page size for current data set
format: int32
example: 100
totalPages:
type: integer
description: Number of pages
format: int32
example: 1
totalRecords:
type: integer
description: Total number of items
format: int32
example: 1000
links:
type: object
description: Map of pagination links with self, next, prev, last and first
example:
next: /organization/bde75a64-f4d5-4ffc-a239-feb607c17ef8/cad-variable?page=2&pageSize=10
last: /organization/bde75a64-f4d5-4ffc-a239-feb607c17ef8/cad-variable?page=3&pageSize=10
prev: /organization/bde75a64-f4d5-4ffc-a239-feb607c17ef8/cad-variable?page=0&pageSize=10
self: /organization/bde75a64-f4d5-4ffc-a239-feb607c17ef8/cad-variable?page=1&pageSize=10
first: /organization/bde75a64-f4d5-4ffc-a239-feb607c17ef8/cad-variable?page=0&pageSize=10
referencedEntities:
type: array
description: List of referenced entities
example:
- agent-profile
- entrypoint
items:
type: string
currentEntity:
type: string
description: Name of current entity
example: entity_name
description: Metadata of response for references with paging information
EntityInfo:
type: object
properties:
id:
type: string
description: id
example: id.
name:
type: string
description: name
example: name.
additionalAttributes:
type: object
additionalProperties:
type: string
description: A map containing additional attributes of entity where both the key and value are Strings.
example: '{"key1":"value1","key2":"value2"}'
description: A map containing additional attributes of entity where both the key and value are Strings.
example:
key1: value1
key2: value2
createdDate:
type: string
lastModifiedDate:
type: string
version:
type: integer
format: int32
EntityReferenceInfoDTO:
type: object
properties:
description:
type: string
description: Description about reference info.
example: list of referenced entities
meta:
$ref: '#/components/schemas/MetaDataReferencesPagingInfo'
data:
type: array
items:
$ref: '#/components/schemas/EntityInfo'
securitySchemes:
oauth2:
flows:
authorizationCode:
authorizationUrl: /
scopes: {}
tokenUrl: /
type: oauth2
bearer-key:
type: http
description: e.g. Bearer YOUR_AUTHORIZATION_TOKEN
scheme: bearer
bearerFormat: JWT
bearerAuth:
type: oauth2
description: OAuth 2.0 Bearer token authentication
flows:
authorizationCode:
authorizationUrl: https://webexapis.com/v1/authorize
tokenUrl: https://webexapis.com/v1/access_token
scopes:
spark:applications_token: Create access tokens for Service Apps