openapi: 3.0.0
info:
title: Webex Admin Address Book Multimedia Profile 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: Multimedia Profile
paths:
/organization/{orgid}/multimedia-profile:
get:
tags:
- Multimedia Profile
summary: List Multimedia Profile(s)
description: Retrieve a list of Multimedia Profile(s) in a given organization.
operationId: getAllConfig_6
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 space, and if so kindly bound it with quotes to apply 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.Default all attributes are returned along with specified columns. All Attributes are supported
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
example: 0
default: 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
example: 100
default: 100
responses:
'200':
description: OK
content:
'*/*':
schema:
type: array
items:
$ref: '#/components/schemas/MultimediaProfileDTO'
'401':
description: Unauthorized Operation
content:
application/json:
schema:
$ref: '#/components/schemas/ApiErrorResponse'
'403':
description: Operation is forbidden
content:
application/json:
schema:
$ref: '#/components/schemas/ApiErrorResponse'
'404':
description: Resource not found or URI is invalid
content:
application/json:
schema:
$ref: '#/components/schemas/ApiErrorResponse'
'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'
'500':
description: An Unexpected Error Occurred
content:
application/json:
schema:
$ref: '#/components/schemas/ApiErrorResponse'
deprecated: false
post:
tags:
- Multimedia Profile
summary: Create a new Multimedia Profile
description: Create a new Multimedia Profile in a given organization.
operationId: createConfig_11
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/MultimediaProfileDTO'
required: true
responses:
'200':
description: OK
content:
'*/*':
schema:
$ref: '#/components/schemas/MultimediaProfileDTO'
'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'
'401':
description: Unauthorized Operation
content:
application/json:
schema:
$ref: '#/components/schemas/ApiErrorResponse'
'403':
description: Operation is forbidden
content:
application/json:
schema:
$ref: '#/components/schemas/ApiErrorResponse'
'409':
description: Similar entity is already present
content:
application/json:
schema:
$ref: '#/components/schemas/ApiErrorResponse'
'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'
'500':
description: An Unexpected Error Occurred
content:
application/json:
schema:
$ref: '#/components/schemas/ApiErrorResponse'
deprecated: false
/organization/{orgid}/multimedia-profile/bulk:
post:
tags:
- Multimedia Profile
summary: Bulk save Multimedia Profile(s)
description: Create, Update or delete Multimedia Profile(s) in bulk in a given organization.
operationId: saveAllConfig_10
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/BulkRequestDTOMultimediaProfileDTO'
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'
'401':
description: Unauthorized Operation
content:
application/json:
schema:
$ref: '#/components/schemas/ApiErrorResponse'
'403':
description: Operation is forbidden
content:
application/json:
schema:
$ref: '#/components/schemas/ApiErrorResponse'
'409':
description: Similar entity is already present
content:
application/json:
schema:
$ref: '#/components/schemas/ApiErrorResponse'
'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'
'500':
description: An Unexpected Error Occurred
content:
application/json:
schema:
$ref: '#/components/schemas/ApiErrorResponse'
deprecated: false
/organization/{orgid}/multimedia-profile/bulk-export:
get:
tags:
- Multimedia Profile
summary: Bulk export Multimedia Profile(s)
description: Export all Multimedia Profile(s) in a given organization.
operationId: bulkExport_10
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
example: 0
default: 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
example: 100
default: 100
responses:
'200':
description: OK
content:
'*/*':
schema:
$ref: '#/components/schemas/BulkExportDTOMultimediaProfileExportDTO'
'401':
description: Unauthorized Operation
content:
application/json:
schema:
$ref: '#/components/schemas/ApiErrorResponse'
'403':
description: Operation is forbidden
content:
application/json:
schema:
$ref: '#/components/schemas/ApiErrorResponse'
'404':
description: Resource not found or URI is invalid
content:
application/json:
schema:
$ref: '#/components/schemas/ApiErrorResponse'
'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'
'500':
description: An Unexpected Error Occurred
content:
application/json:
schema:
$ref: '#/components/schemas/ApiErrorResponse'
deprecated: true
/organization/{orgid}/multimedia-profile/purge-inactive-entities:
post:
tags:
- Multimedia Profile
summary: Purge inactive Multimedia Profile(s)
description: Purge inactive Multimedia Profile(s) older than the configured interval for a given organization.
operationId: purgeInactiveConfig_5
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: nextStartId
in: query
description: This is the entity ID from which items for the next purge batch with be selected.
required: false
schema:
type: string
default: ''
example: af9eecc5-0472-4549-9a83-2afdae0d4ba0
responses:
'200':
description: OK
content:
'*/*':
schema:
$ref: '#/components/schemas/Response'
'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'
'401':
description: Unauthorized Operation
content:
application/json:
schema:
$ref: '#/components/schemas/ApiErrorResponse'
'403':
description: Operation is forbidden
content:
application/json:
schema:
$ref: '#/components/schemas/ApiErrorResponse'
'409':
description: Similar entity is already present
content:
application/json:
schema:
$ref: '#/components/schemas/ApiErrorResponse'
'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'
'500':
description: An Unexpected Error Occurred
content:
application/json:
schema:
$ref: '#/components/schemas/ApiErrorResponse'
deprecated: false
/organization/{orgid}/multimedia-profile/{id}:
get:
tags:
- Multimedia Profile
summary: Get specific Multimedia Profile by ID
description: Retrieve an existing Multimedia Profile by ID in a given organization.
operationId: getConfig_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: Resource ID of the Multimedia Profile.
required: true
schema:
type: string
example: 2f9eecc5-0472-4549
responses:
'200':
description: OK
content:
'*/*':
schema:
$ref: '#/components/schemas/MultimediaProfileDTO'
'401':
description: Unauthorized Operation
content:
application/json:
schema:
$ref: '#/components/schemas/ApiErrorResponse'
'403':
description: Operation is forbidden
content:
application/json:
schema:
$ref: '#/components/schemas/ApiErrorResponse'
'404':
description: Resource not found or URI is invalid
content:
application/json:
schema:
$ref: '#/components/schemas/ApiErrorResponse'
'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'
'500':
description: An Unexpected Error Occurred
content:
application/json:
schema:
$ref: '#/components/schemas/ApiErrorResponse'
deprecated: false
put:
tags:
- Multimedia Profile
summary: Update specific Multimedia Profile by ID
description: Update an existing Multimedia Profile by ID in a given organization.
operationId: updateConfig_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: Resource ID of the Multimedia Profile.
required: true
schema:
type: string
example: 2f9eecc5-0472-4549
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/MultimediaProfileDTO'
required: true
responses:
'200':
description: OK
content:
'*/*':
schema:
$ref: '#/components/schemas/MultimediaProfileDTO'
'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'
'401':
description: Unauthorized Operation
content:
application/json:
schema:
$ref: '#/components/schemas/ApiErrorResponse'
'403':
description: Operation is forbidden
content:
application/json:
schema:
$ref: '#/components/schemas/ApiErrorResponse'
'404':
description: Resource not found or URI is invalid
content:
application/json:
schema:
$ref: '#/components/schemas/ApiErrorResponse'
'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'
'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'
'500':
description: An Unexpected Error Occurred
content:
application/json:
schema:
$ref: '#/components/schemas/ApiErrorResponse'
deprecated: false
delete:
tags:
- Multimedia Profile
summary: Delete specific Multimedia Profile by ID
description: Delete an existing Multimedia Profile by ID in a given organization.
operationId: deleteConfig_11
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 Multimedia Profile.
required: true
schema:
type: string
example: 2f9eecc5-0472-4549
responses:
'200':
description: OK
'401':
description: Unauthorized Operation
content:
application/json:
schema:
$ref: '#/components/schemas/ApiErrorResponse'
'403':
description: Operation is forbidden
content:
application/json:
schema:
$ref: '#/components/schemas/ApiErrorResponse'
'404':
description: Resource not found or URI is invalid
content:
application/json:
schema:
$ref: '#/components/schemas/ApiErrorResponse'
'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'
'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'
'500':
description: An Unexpected Error Occurred
content:
application/json:
schema:
$ref: '#/components/schemas/ApiErrorResponse'
deprecated: false
/organization/{orgid}/multimedia-profile/{id}/incoming-references:
get:
tags:
- Multimedia Profile
summary: List references for a specific Multimedia Profile
description: Retrieve a list of all entities that have reference to an existing Multimedia Profile by ID in a given organization.
operationId: getIncomingReferences_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: 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
example: 0
default: 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
example: 100
default: 100
responses:
'200':
description: OK
content:
'*/*':
schema:
$ref: '#/components/schemas/EntityReferenceInfoDTO'
'401':
description: Unauthorized Operation
content:
application/json:
schema:
$ref: '#/components/schemas/ApiErrorResponse'
'403':
description: Operation is forbidden
content:
application/json:
schema:
$ref: '#/components/schemas/ApiErrorResponse'
'404':
description: Resource not found or URI is invalid
content:
application/json:
schema:
$ref: '#/components/schemas/ApiErrorResponse'
'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'
'500':
description: An Unexpected Error Occurred
content:
application/json:
schema:
$ref: '#/components/schemas/ApiErrorResponse'
deprecated: false
/organization/{orgid}/v2/multimedia-profile:
get:
tags:
- Multimedia Profile
summary: List Multimedia Profile(s)
description: Retrieve a list of Multimedia Profile(s) in a given organization.
operationId: getAllConfigWithMetaData_13
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 space, and if so kindly bound it with quotes to apply 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.Default all attributes are returned along with specified columns. All Attributes are supported
required: false
schema:
type: string
format: string
example: id
- name: search
in: query
description: 'Filter data based on the search keyword.Supported search columns(name, description)
The examples below show some search queries
- "Cisco"
- field=="name";value=="Cisco"
- fields=in=("name","description");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
example: 0
default: 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
example: 100
default: 100
responses:
'200':
description: OK
content:
'*/*':
schema:
$ref: '#/components/schemas/ResponseEnvelopeMultimediaProfileDTO'
'401':
description: Unauthorized Operation
content:
application/json:
schema:
$ref: '#/components/schemas/ApiErrorResponse'
'403':
description: Operation is forbidden
content:
application/json:
schema:
$ref: '#/components/schemas/ApiErrorResponse'
'404':
description: Resource not found or URI is invalid
content:
application/json:
schema:
$ref: '#/components/schemas/ApiErrorResponse'
'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'
'500':
description: An Unexpected Error Occurred
content:
application/json:
schema:
$ref: '#/components/schemas/ApiErrorResponse'
deprecated: false
components:
schemas:
Response:
type: object
properties:
code:
type: integer
format: int32
details:
type: object
additionalProperties:
type: object
links:
type: array
items:
$ref: '#/components/schemas/Link'
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'
BulkRequestItemDTOMultimediaProfileDTO:
type: object
properties:
itemIdentifier:
type: integer
description: Unique item identifier for a bulk operation.
format: int32
example: 10
item:
$ref: '#/components/schemas/MultimediaProfileDTO'
requestAction:
type: string
description: Identifier for action type. Possible values can be SAVE and DELETE.
example: SAVE
BulkExportDTOMultimediaProfileExportDTO:
type: object
properties:
totalResources:
type: integer
description: Total number of items
format: int32
example: 100
pageNumber:
type: integer
description: Current page number
format: int32
example: 0
pageSize:
type: integer
description: Page size for current data set
format: int32
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
items:
$ref: '#/components/schemas/MultimediaProfileExportDTO'
ResponseEnvelopeMultimediaProfileDTO:
type: object
properties:
meta:
type: object
additionalProperties:
type: object
data:
type: array
items:
$ref: '#/components/schemas/MultimediaProfileDTO'
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
Link:
type: object
properties:
href:
type: string
hreflang:
type: string
title:
type: string
type:
type: string
deprecation:
type: string
profile:
type: string
name:
type: string
templated:
type: boolean
MultimediaProfileExportDTO:
type: object
properties:
name:
type: string
description:
type: string
chat:
type: integer
format: int32
email:
type: integer
format: int32
fax:
type: integer
format: int32
telephony:
type: integer
format: int32
video:
type: integer
format: int32
social:
type: integer
format: int32
others:
type: integer
format: int32
active:
type: boolean
blendingModeEnabled:
type: boolean
blendingMode:
type: string
manuallyAssignable:
$ref: '#/components/schemas/MultimediaProfileChannelDTO'
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.
MultimediaProfileDTO:
required:
- active
- blendingMode
- blendingModeEnabled
- chat
- email
- name
- social
- telephony
type: object
properties:
organizationId:
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: ID of the contact center organization. It is required to define for the following operations - All bulk save operations
format: uuid
example: f53c8b54-46ca-43f6-ba05-08426a46e23d
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
description: The version of this resource. For a newly created resource, it will be 0 unless specified otherwise.
format: int32
example: 1
name:
maxLength: 80
minLength: 0
pattern: ^[a-zA-Z0-9._\-\s]*$
type: string
description: Enter the name for the multimedia profile. Generally, use names that indicate the type of the profile, such as Default Telephony Profile.
example: Default Telephony Profile
description:
maxLength: 255
minLength: 0
type: string
description: Enter a description for the multimedia profile.
example: This multimedia profile is for Default Telephony Profile
chat:
type: integer
description: Define the upper limits for this channel type. It should range from 0 or 1(depends on the 'BlendingMode') to 5.
format: int32
example: 0
email:
type: integer
description: Define the upper limits for this channel type. It should range from 0 to 5.
format: int32
example: 5
telephony:
type: integer
description: Define the upper limits for this channel type. It should be either 0 or 1(depends on the 'BlendingMode').
format: int32
example: 0
social:
type: integer
description: Define the upper limits for this channel type. It should range from 0 to 5.
format: int32
example: 4
active:
type: boolean
description: Specify whether the multimedia profile is active or not.
example: true
blendingModeEnabled:
type: boolean
description: Specify whether the blending mode is enabled or not for a multimedia profile.
example: true
blendingMode:
type: string
description: 'Blending mode can be one the following:
BLENDED: This mode allows agents to handle multiple contacts of different channel types simultaneously. Number of contacts that you can set for Voice: 0–1 and for Chat, Email, and Social Channel: 0–5
BLENDED_REALTIME: This allows agents to handle a contact of one real-time channel at a time - either voice or chat. Along with this they can handle non-realtime contacts which include email and social channels. Number of contacts that you can set for Voice: 1 (mandatory), Chat: 1–5, Email and Social Channel: 0–5
EXCLUSIVE: This mode allows agents to focus on one customer contact at a time.'
example: BLENDED
systemDefault:
type: boolean
description: Indicates whether the created resource is system created or not
example: false
manuallyAssignable:
$ref: '#/components/schemas/MultimediaProfileChannelDTO'
createdTime:
type: integer
description: Creation time(in epoch millis) of this resource.
format: int64
readOnly: true
example: 1617536244000
lastUpdatedTime:
type: integer
description: Time(in epoch millis) when this resource was last updated.
format: int64
readOnly: true
example: 1617536244000
BulkResponseDTO:
type: object
properties:
items:
type: array
items:
$ref: '#/components/schemas/BulkResponseItemDTO'
BulkRequestDTOMultimediaProfileDTO:
type: object
properties:
items:
type: array
items:
$ref: '#/components/schemas/BulkRequestItemDTOMultimediaProfileDTO'
MultimediaProfileChannelDTO:
required:
- chat
- email
- social
- telephony
type: object
properties:
organizationId:
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: ID of the contact center organization. It is required to define for the following operations - All bulk save operations
format: uuid
example: f53c8b54-46ca-43f6-ba05-08426a46e23d
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
description: The version of this resource. For a newly created resource, it will be 0 unless specified otherwise.
format: int32
example: 1
telephony:
type: integer
description: Define the upper limits for this channel type. It should be either 0 or 1.
format: int32
example: 0
chat:
type: integer
description: Define the upper limits for this channel type. It should range from 0 to 5.
format: int32
example: 5
email:
type: integer
description: Define the upper limits for this channel type. It should range from 0 to 10.
format: int32
example: 5
social:
type: integer
description: Define the upper limits for this channel type. It should range from 0 to 5.
format: int32
example: 4
createdTime:
type: integer
description: Creation time(in epoch millis) of this resource.
format: int64
readOnly: true
example: 1617536244000
lastUpdatedTime:
type: integer
description: Time(in epoch millis) when this resource was last updated.
format: int64
readOnly: true
example: 1617536244000
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