openapi: 3.0.0
info:
title: Webex Admin Address Book Contact Service Queue 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: Contact Service Queue
paths:
/organization/{orgid}/contact-service-queue:
get:
tags:
- Contact Service Queue
summary: List Contact Service Queue(s)
description: "Retrieve a list of Contact Service Queue(s) in a given organization.\n Note: Array fields are removed from List API. If all fields are required please fetch Id's and use get-by-id API."
operationId: getAllFilteredConfig_1
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: channelTypes
in: query
description: ' [DEPRECATED] Channel type(s) allowed by the system.Separate values with commas.Use uppercase. By default, there is no channel type filtering.'
required: false
style: form
explode: false
schema:
type: array
items:
type: string
example:
- TELEPHONY
- CHAT
- 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 (callDistributionGroups,queueSkillRequirements,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
- name: singleObjectResponse
in: query
description: Specifiy whether to include array fields in the response, This query param should use only if the response contain single record, if we are using for multiple objects response query param not supported and throws an exception.
schema:
type: boolean
default: false
example: false
responses:
'200':
description: OK
content:
'*/*':
schema:
type: array
items:
$ref: '#/components/schemas/ContactServiceQueueDTOList'
example:
- recordingPermitted: true
ivrRequeueUrl: https://www.youtube.com
agentsLastUpdatedByUserEmailPrefix: string
personalizedAIRouting: string
timezone: America/New_York
socialChannelType: MESSENGER
controlFlowScriptUrl: https://flow-control.produs1.ciscoccservice.com/31f1c57f-4fa1-417b-b5c5-6feb6abea062/royal-enfield
description: Queue created by system
monitoringPermitted: true
vendorId: AB123CSDR
queueLevelRealTimeTranscriptionsInclusion: INCLUDED
channelType: TELEPHONY
queueRoutingType: TEAM_BASED
recordingAllCallsPermitted: true
organizationId: f53c8b54-46ca-43f6-ba05-08426a46e23d
recordingPauseDuration: 2
systemDefault: false
defaultMusicInQueueMediaFileId: defaultmusic_on_hold.wav
queueLevelPredictedWaitTimeInclusion: INCLUDED
queueLevelAutoCsatInclusion: INCLUDED
serviceLevelThreshold: 0
routingType: SKILLS_BASED
skillBasedRoutingType: BEST_AVAILABLE_AGENT
createdTime: string
lastUpdatedTime: string
id: 93912f11-6017-404b-bf14-5331890b1797
maxTimeInQueue: 2
xspVersion: xsp-24.0
maxActiveContacts: 5
pauseRecordingPermitted: true
checkAgentAvailability: true
outdialCampaignEnabled: true
assistantSkill: string
parkingPermitted: true
agentsLastUpdatedByUserName: string
active: true
version: 1
queueLevelSummariesInclusion: INCLUDED
overflowNumber: '1245677'
agentsLastUpdatedTime: 1742556600000
queueLevelSentimentAnalysisInclusion: INCLUDED
name: Queue-1
queueType: INBOUND
subscriptionId: 04d0bdf6-6d6a-4aae-8a8a-71c9152e6478
manuallyAssignable: false
'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: []
post:
tags:
- Contact Service Queue
summary: Create a new Contact Service Queue
description: Create a new Contact Service Queue in a given organization.
operationId: createConfig_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
requestBody:
description: The Contact Service Queue object to create.
content:
application/json:
schema:
$ref: '#/components/schemas/ContactServiceQueueDTO'
required: true
responses:
'201':
description: Created
content:
'*/*':
schema:
$ref: '#/components/schemas/ContactServiceQueueDTO'
'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: []
/organization/{orgid}/contact-service-queue/bulk:
post:
tags:
- Contact Service Queue
summary: Bulk save Contact Service Queue(s)
description: Create, Update or delete Contact Service Queue(s) in bulk in a given organization.
operationId: saveAllConfig_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
requestBody:
description: The list of Contact Service Queue items for bulk save.
content:
application/json:
schema:
$ref: '#/components/schemas/BulkRequestDTOContactServiceQueueDTO'
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: []
patch:
tags:
- Contact Service Queue
summary: Bulk partial update Contact Service Queue(s)
description: Update some or all properties for multiple Contact Service Queue(s) in bulk in a given organization.
operationId: patchAllConfig_1
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:
description: 'For each of the item to update,
We only need to provide the patch JSON.
Only the following properties are mandatory to identify unique item for update. Other properties are optional.
Mandatory Properties: [id]
All properties that can be updated via PUT Api are allowed to be updated.
To nullify a property or remove it, specify null as value for the Json property.
Valid value for requestAction property is ''SAVE''. It is optional property and default SAVE is assumed.
'
content:
application/json:
schema:
$ref: '#/components/schemas/BulkRequestDTOContactServiceQueueDTO'
example:
items:
- item:
id: 26e2df70-0f77-41b8-8e8f-1d76e92c9638
assistantSkill:
assistantSkillId: 26e2df70-0f77-41b8-8e8f-1d76e92c9639
itemIdentifier: 0
requestAction: SAVE
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: []
'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: []
/organization/{orgid}/contact-service-queue/bulk-export:
get:
tags:
- Contact Service Queue
summary: Bulk export Contact Service Queue(s)
description: Export all Contact Service Queue(s) in a given organization.
operationId: bulkExport_14
deprecated: true
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: type
in: query
description: Indicates the queue type; can be INBOUND or OUTBOUND.
required: true
schema:
type: string
enum:
- INBOUND
- OUTBOUND
example: INBOUND
- 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/BulkExportDTOContactServiceQueueBulkExportDTO'
'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: []
/organization/{orgid}/contact-service-queue/by-skill-profile-id/{id}:
get:
tags:
- Contact Service Queue
summary: List Skill CSQs by Skill Profile
description: Retrieve skill-based Contact Service Queues by skill profile ID in a given organization.
operationId: getSkillBasedCSQsBySkillProfileIdPublic
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
responses:
'200':
description: OK
content:
'*/*':
schema:
$ref: '#/components/schemas/ResponseEnvelopeSkillBasedCSQDTO'
'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: []
/organization/{orgid}/contact-service-queue/by-skill-profile-id/{id}/internal:
get:
tags:
- Contact Service Queue
summary: List Internal Skill CSQs by Profile
description: Retrieve skill-based Contact Service Queues by skill profile ID for internal use in a given organization.
operationId: getSkillBasedCSQsBySkillProfileId
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
responses:
'200':
description: OK
content:
'*/*':
schema:
$ref: '#/components/schemas/ResponseEnvelopeSkillBasedCSQDTO'
'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: []
/organization/{orgid}/contact-service-queue/by-team-id/{id}/internal:
get:
tags:
- Contact Service Queue
summary: List Team CSQs by Team ID
description: Retrieve team-based Contact Service Queues by team ID for internal use in a given organization.
operationId: getTeamBasedCSQByTeamId
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
responses:
'200':
description: OK
content:
'*/*':
schema:
$ref: '#/components/schemas/ResponseEnvelopeMappedCSQDTO'
'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: []
/organization/{orgid}/contact-service-queue/by-user-ci-id/{ciUserId}/internal:
get:
tags:
- Contact Service Queue
summary: List Agent CSQs by CI User ID
description: Retrieve agent-based Contact Service Queues by CI user ID for internal use in a given organization.
operationId: getAgentBasedCSQsByCiUserId
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: ciUserId
in: path
description: ciUserId
required: true
schema:
type: string
example: af9eecc5-0472-4549-9a83-2afdae0d4ba0
responses:
'200':
description: OK
content:
'*/*':
schema:
$ref: '#/components/schemas/ResponseEnvelopeMappedCSQDTO'
'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: []
/organization/{orgid}/contact-service-queue/delete-reference:
post:
tags:
- Contact Service Queue
summary: Delete CSQ References
description: Delete references for Contact Service Queues in a given organization.
operationId: deleteReferences
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
requestBody:
description: The field references to delete.
content:
application/json:
schema:
$ref: '#/components/schemas/FieldRequestBody'
required: true
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'
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: []
/organization/{orgid}/contact-service-queue/fetch-by-dynamic-skills-and-skillProfile:
post:
tags:
- Contact Service Queue
summary: List CSQs by Skills and Profile
description: Retrieve skill-based Contact Service Queues by dynamic skills and skill profile in a given organization.
operationId: getSkillBasedCSQsByDynamicSkillsAndSkillProfile
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:
description: The skill profile and dynamic skills filter criteria.
content:
application/json:
schema:
$ref: '#/components/schemas/SkillBasedQueueRequestDTO'
required: true
responses:
'200':
description: OK
content:
'*/*':
schema:
$ref: '#/components/schemas/ResponseEnvelopeMappedCSQDTO'
'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: []
/organization/{orgid}/contact-service-queue/fetch-by-userId-skillProfileId:
post:
tags:
- Contact Service Queue
summary: List CSQs by User and Profile
description: Retrieve skill-based Contact Service Queues by user ID and skill profile ID in a given organization.
operationId: getSkillBasedCSQsBySkillProfileIdAndUserId
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:
description: The user ID and skill profile filter criteria.
content:
application/json:
schema:
$ref: '#/components/schemas/SkillBasedQueueRequestDTO'
required: true
responses:
'200':
description: OK
content:
'*/*':
schema:
$ref: '#/components/schemas/ResponseEnvelopeMappedCSQDTO'
'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: []
/organization/{orgid}/contact-service-queue/fetch-manually-assignable-queues:
post:
tags:
- Contact Service Queue
summary: List Manually Assignable CSQs
description: Retrieve manually assignable Contact Service Queues in a given organization.
operationId: getManuallyAssignableCSQs
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:
description: The agent and team filter criteria for assignable queues.
content:
application/json:
schema:
$ref: '#/components/schemas/ManuallyAssignableQueuesRequest'
required: true
responses:
'200':
description: OK
content:
'*/*':
schema:
$ref: '#/components/schemas/ResponseEnvelopeMappedCSQDTO'
'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: []
/organization/{orgid}/contact-service-queue/purge-inactive-entities:
post:
tags:
- Contact Service Queue
summary: Purge inactive Contact Service Queue(s)
description: Purge inactive Contact Service Queue(s) older than the configured interval for a given organization.
operationId: purgeInactiveConfig_8
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'
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: []
/organization/{orgid}/contact-service-queue/skill-based-queues/by-ci-user-id/{id}/internal:
get:
tags:
- Contact Service Queue
summary: List Skill CSQs by CI User ID
description: Retrieve skill-based Contact Service Queues by CI user ID for internal use in a given organization.
operationId: getSkillBasedCSQsByCiUserId
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
responses:
'200':
description: OK
content:
'*/*':
schema:
$ref: '#/components/schemas/ResponseEnvelopeSkillBasedCSQDTO'
'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: []
/organization/{orgid}/contact-service-queue/{id}:
get:
tags:
- Contact Service Queue
summary: Get specific Contact Service Queue by ID
description: Retrieve an existing Contact Service Queue by ID in a given organization.
operationId: getConfig_18
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 Contact Service Queue.
required: true
schema:
type: string
example: 2f9eecc5-0472-4549-9a83-2afdae0d4ba2
- name: agentsUpdatedInfo
in: query
description: If `true`, returns the user details who has last updated the agents list in an agent based queue.
schema:
type: boolean
default: false
example: false
responses:
'200':
description: OK
content:
'*/*':
schema:
$ref: '#/components/schemas/ContactServiceQueueDTO'
'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: []
put:
tags:
- Contact Service Queue
summary: Update specific Contact Service Queue by ID
description: Update an existing Contact Service Queue by ID in a given organization.
operationId: updateConfig_18
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 Contact Service Queue.
required: true
schema:
type: string
example: 2f9eecc5-0472-4549-9a83-2afdae0d4ba2
requestBody:
description: The updated Contact Service Queue object.
content:
application/json:
schema:
$ref: '#/components/schemas/ContactServiceQueueDTO'
required: true
responses:
'200':
description: OK
content:
'*/*':
schema:
$ref: '#/components/schemas/ContactServiceQueueDTO'
'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: []
delete:
tags:
- Contact Service Queue
summary: Delete specific Contact Service Queue by ID
description: Delete an existing Contact Service Queue by ID in a given organization.
operationId: deleteConfig_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 Contact Service Queue.
required: true
schema:
type: string
example: 2f9eecc5-0472-4549-9a83-2afdae0d4ba2
responses:
'204':
description: No Content
'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: []
/organization/{orgid}/contact-service-queue/{id}/incoming-references:
get:
tags:
- Contact Service Queue
summary: List CSQ References by ID
description: Retrieve a list of all entities that have reference to an existing Contact Service Queue by ID in a given organization.
operationId: getIncomingReferences_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: 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: []
/organization/{orgid}/contact-service-queue/v2/bulk:
post:
tags:
- Contact Service Queue
summary: Bulk save Contact Service Queue(s)
description: Create, Update or delete Contact Service Queue(s) in bulk in a given organization.
operationId: saveAllConfigV2
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/BulkRequestDTOContactServiceQueueDTO'
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: []
/organization/{orgid}/v2/contact-service-queue:
get:
tags:
- Contact Service Queue
summary: List Contact Service Queue(s)
description: "Retrieve a list of Contact Service Queue(s) in a given organization.\n Note: Array fields are removed from List API. If all fields are required please fetch Id's and use get-by-id API."
operationId: getAllFilteredConfigWithPagedMetaData
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, queueSkillRequirements, xspVersion, 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 (callDistributionGroups,queueSkillRequirements,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(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
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: desktopProfileFilter
in: query
description: If set to true, the API will return only the data that the user has access to according to its Desktop Profile. If unspecified, the default value is false.
schema:
type: boolean
default: false
example: true
- name: provisioningView
in: query
description: If set to true, the API will only return data that user has access to, according to User Profile. This query parameter is applicable only when desktopProfileFilter query parameter is false.
schema:
type: boolean
default: false
example: false
- name: singleObjectResponse
in: query
description: Specifiy whether to include array fields in the response, This query param should use only if the response contain single record, if we are using for multiple objects response query param not supported and throws an exception.
schema:
type: boolean
default: false
example: false
- name: includeAIMappingCount
in: query
description: If set to true, the API response will include the count of each AI features mapped to the entity.
schema:
type: boolean
default: false
responses:
'200':
description: OK
content:
'*/*':
schema:
type: object
properties:
meta:
$ref: '#/components/schemas/MetaDataPagedCSQ'
data:
type: array
items:
$ref: '#/components/schemas/ContactServiceQueueDTO'
example:
data:
- recordingPermitted: true
ivrRequeueUrl: https://www.youtube.com
agentsLastUpdatedByUserEmailPrefix: string
personalizedAIRouting: string
timezone: America/New_York
socialChannelType: MESSENGER
controlFlowScriptUrl: https://flow-control.produs1.ciscoccservice.com/31f1c57f-4fa1-417b-b5c5-6feb6abea062/royal-enfield
description: Queue created by system
monitoringPermitted: true
vendorId: AB123CSDR
queueLevelRealTimeTranscriptionsInclusion: INCLUDED
channelType: TELEPHONY
queueRoutingType: TEAM_BASED
recordingAllCallsPermitted: true
organizationId: f53c8b54-46ca-43f6-ba05-08426a46e23d
recordingPauseDuration: 2
systemDefault: false
defaultMusicInQueueMediaFileId: defaultmusic_on_hold.wav
queueLevelPredictedWaitTimeInclusion: INCLUDED
queueLevelAutoCsatInclusion: INCLUDED
serviceLevelThreshold: 0
routingType: SKILLS_BASED
skillBasedRoutingType: BEST_AVAILABLE_AGENT
createdTime: string
lastUpdatedTime: string
id: 93912f11-6017-404b-bf14-5331890b1797
maxTimeInQueue: 2
xspVersion: xsp-24.0
maxActiveContacts: 5
pauseRecordingPermitted: true
checkAgentAvailability: true
outdialCampaignEnabled: true
assistantSkill: string
parkingPermitted: true
agentsLastUpdatedByUserName: string
active: true
version: 1
queueLevelSummariesInclusion: INCLUDED
overflowNumber: 1245677
agentsLastUpdatedTime: '2025-03-21T10:30:00Z'
queueLevelSentimentAnalysisInclusion: INCLUDED
name: Queue-1
queueType: INBOUND
subscriptionId: 04d0bdf6-6d6a-4aae-8a8a-71c9152e6478
manuallyAssignable: false
meta:
additionalProp1: string
additionalProp3: string
additionalProp2: 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: []
post:
tags:
- Contact Service Queue
summary: Create a new Contact Service Queue
description: Create a new Contact Service Queue in a given organization.
operationId: createConfig_17
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/ContactServiceQueueDTO'
required: true
responses:
'201':
description: Created
content:
'*/*':
schema:
$ref: '#/components/schemas/ContactServiceQueueDTO'
'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: []
/organization/{orgid}/v2/contact-service-queue/by-user-id/{userid}/agent-based-queues:
get:
tags:
- Contact Service Queue
summary: List agent based Contact Service Queue(s)by user ID
description: Retrieve a list of agent based Contact Service Queue(s) by user iD in a given organization.
operationId: getCSQByUserIDForAgentBasedQueue
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: userid
in: path
required: true
schema:
type: string
- name: search
in: query
description: 'Filter data based on the search keyword.Supported search columns(firstName, lastName, email)
The examples below show some search queries
- "Cisco"
- field=="firstName";value=="Cisco"
- fields=in=("firstName","lastName");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
- 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
responses:
'200':
description: OK
content:
'*/*':
schema:
$ref: '#/components/schemas/ResponseEnvelopeRoutingBasedQueueDTO'
'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: []
/organization/{orgid}/v2/contact-service-queue/by-user-id/{userid}/skill-based-queues:
get:
tags:
- Contact Service Queue
summary: List skill based Contact Service Queue(s)by user ID
description: Retrieve a list of skill based Contact Service Queue(s) by user ID in a given organization.
operationId: getSkillBasedQueuesByUserId
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: userid
in: path
required: true
schema:
type: string
- name: search
in: query
description: 'Filter data based on the search keyword.Supported search columns(firstName, lastName, email)
The examples below show some search queries
- "Cisco"
- field=="firstName";value=="Cisco"
- fields=in=("firstName","lastName");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
- 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
responses:
'200':
description: OK
content:
'*/*':
schema:
$ref: '#/components/schemas/ResponseEnvelopeRoutingBasedQueueDTO'
'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: []
/organization/{orgid}/v2/contact-service-queue/by-user-id/{userid}/team-based-queues:
get:
tags:
- Contact Service Queue
summary: List team based Contact Service Queue(s)by user ID
description: Retrieve a list of team based Contact Service Queue(s) by user ID in a given organization.
operationId: getCSQByUserIDForTeamBasedQueue
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: userid
in: path
required: true
schema:
type: string
- name: search
in: query
description: 'Filter data based on the search keyword.Supported search columns(firstName, lastName, email)
The examples below show some search queries
- "Cisco"
- field=="firstName";value=="Cisco"
- fields=in=("firstName","lastName");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
- 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
responses:
'200':
description: OK
content:
'*/*':
schema:
$ref: '#/components/schemas/ResponseEnvelopeRoutingBasedQueueDTO'
'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: []
/organization/{orgid}/v2/contact-service-queue/fetch-by-grouped-assistant-skill:
post:
tags:
- Contact Service Queue
summary: List queue mapping summary grouped by Assistant Skill
description: Retrieve a list of queue mapping summary for a specified list of Assistant Skills specified in a given organization. The summary currently includes mapped queue count, and the last assigned time of queue mapping.
operationId: getAllCSQGroupedAssistantSkill
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
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/CSQGroupedAssistantSkillRequestDTO'
required: true
responses:
'200':
description: OK
content:
'*/*':
schema:
$ref: '#/components/schemas/ResponseEnvelopeCSQGroupedAssistantSkillResponseDTO'
'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: []
/organization/{orgid}/v2/contact-service-queue/{id}:
get:
tags:
- Contact Service Queue
summary: Get specific Contact Service Queue by ID
description: Retrieve an existing Contact Service Queue by ID in a given organization.
operationId: getConfig_19
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 Contact Service Queue.
required: true
schema:
type: string
example: 2f9eecc5-0472-4549-9a83-2afdae0d4ba2
- name: agentsUpdatedInfo
in: query
description: If `true`, returns the user details who has last updated the agents list in an agent based queue.
schema:
type: boolean
default: false
example: false
responses:
'200':
description: OK
content:
'*/*':
schema:
$ref: '#/components/schemas/ContactServiceQueueDTO'
'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: []
put:
tags:
- Contact Service Queue
summary: Update specific Contact Service Queue by ID
description: Update an existing Contact Service Queue by ID in a given organization.
operationId: updateConfig_19
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 Contact Service Queue.
required: true
schema:
type: string
example: 2f9eecc5-0472-4549-9a83-2afdae0d4ba2
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/ContactServiceQueueDTO'
required: true
responses:
'200':
description: OK
content:
'*/*':
schema:
$ref: '#/components/schemas/ContactServiceQueueDTO'
'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: []
/organization/{orgid}/v2/contact-service-queue/{id}/reassign-agents:
post:
tags:
- Contact Service Queue
summary: Add or remove agents/users to/from an agent based queue
description: This API can be used by a contact center supervisor to add or remove agents to/from an agent based queue that they have access to by virtue of their user profile access rights. Additionally, the request payload should contain the user id(s) managed by the supervisor.
operationId: reassignAgents
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 Contact Service Queue.
required: true
schema:
type: string
example: af9eecc5-0472-4549-9a83-2afdae0d4ba0
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/ReassignAgentsRequestDTO'
required: true
responses:
'200':
description: OK
content:
'*/*':
schema:
type: object
'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: []
/organization/{orgid}/v3/contact-service-queue:
get:
tags:
- Contact Service Queue
summary: List Contact Service Queue(s)
description: "Retrieve a list of Contact Service Queue(s) in a given organization.\n Note: Array fields are removed from List API. If all fields are required please fetch Id's and use get-by-id API."
operationId: getAllFilteredConfigWithMetaDataV3
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, queueSkillRequirements, xspVersion, 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 (callDistributionGroups,queueSkillRequirements,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(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
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: desktopProfileFilter
in: query
description: If set to true, the API will return only the data that the user has access to according to its Desktop Profile. If unspecified, the default value is false.
schema:
type: boolean
default: false
example: false
- name: provisioningView
in: query
description: If set to true, the API will only return data that user has access to, according to User Profile. This query parameter is applicable only when desktopProfileFilter query parameter is false.
schema:
type: boolean
default: false
example: false
- name: singleObjectResponse
in: query
description: Specifiy whether to include array fields in the response, This query param should use only if the response contain single record, if we are using for multiple objects response query param not supported and throws an exception.
schema:
type: boolean
default: false
example: false
responses:
'200':
description: OK
content:
'*/*':
schema:
$ref: '#/components/schemas/ResponseMetaEnvelopeContactServiceQueueDTOMetaDataPagedInfo'
example:
- recordingPermitted: true
ivrRequeueUrl: https://www.youtube.com
agentsLastUpdatedByUserEmailPrefix: string
personalizedAIRouting: string
timezone: America/New_York
socialChannelType: MESSENGER
controlFlowScriptUrl: https://flow-control.produs1.ciscoccservice.com/31f1c57f-4fa1-417b-b5c5-6feb6abea062/royal-enfield
description: Queue created by system
monitoringPermitted: true
vendorId: AB123CSDR
queueLevelRealTimeTranscriptionsInclusion: INCLUDED
channelType: TELEPHONY
queueRoutingType: TEAM_BASED
recordingAllCallsPermitted: true
organizationId: f53c8b54-46ca-43f6-ba05-08426a46e23d
recordingPauseDuration: 2
systemDefault: false
defaultMusicInQueueMediaFileId: defaultmusic_on_hold.wav
queueLevelPredictedWaitTimeInclusion: INCLUDED
queueLevelAutoCsatInclusion: INCLUDED
serviceLevelThreshold: 0
routingType: SKILLS_BASED
skillBasedRoutingType: BEST_AVAILABLE_AGENT
createdTime: string
lastUpdatedTime: string
id: 93912f11-6017-404b-bf14-5331890b1797
maxTimeInQueue: 2
xspVersion: xsp-24.0
maxActiveContacts: 5
pauseRecordingPermitted: true
checkAgentAvailability: true
outdialCampaignEnabled: true
assistantSkill: string
parkingPermitted: true
agentsLastUpdatedByUserName: string
active: true
version: 1
queueLevelSummariesInclusion: INCLUDED
overflowNumber: 1245677
agentsLastUpdatedTime: '2025-03-21T10:30:00Z'
queueLevelSentimentAnalysisInclusion: INCLUDED
name: Queue-1
queueType: INBOUND
subscriptionId: 04d0bdf6-6d6a-4aae-8a8a-71c9152e6478
manuallyAssignable: false
'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
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'
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
SkillBasedQueueRequestDTO:
type: object
description: Request DTO for querying skill-based Contact Service Queues.
properties:
skillProfileId:
type: string
description: The skill profile ID to filter queues by.
dynamicSkills:
type: array
description: List of dynamic skills to filter queues by.
items:
$ref: '#/components/schemas/DynamicSkillDTO'
userId:
type: string
description: The user ID to filter queues by.
ResponseEnvelopeMappedCSQDTO:
type: object
description: Response envelope containing mapped Contact Service Queue data.
properties:
meta:
type: object
description: Metadata about the response.
additionalProperties: {}
data:
type: array
description: List of mapped Contact Service Queue items.
items:
$ref: '#/components/schemas/MappedCSQDTO'
ContactServiceQueueDTO:
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
name:
type: string
description: Name of the Contact Service Queue
example: Queue-1
description:
type: string
description: (Optional) A short description of the queue.
example: Queue created by system
queueType:
type: string
description: 'This can be the following
INBOUND
OUTBOUND'
enum:
- INBOUND
- OUTBOUND
example: INBOUND
checkAgentAvailability:
type: boolean
description: This setting specifies whether the system can exclude teams with no logged in agents for the relevant routing strategies. It does not support Social Channel Type.
example: true
channelType:
type: string
description: "Setting to indicate the channel type. Use uppercase. Supported channel types are: \n\n TELEPHONY, EMAIL, SOCIAL_CHANNEL, and CHAT. \n\nFor TELEPHONY channelType, the following fields are mandatory - recordingPermitted, ivrRequeueUrl, recordingAllCallsPermitted, monitoringPermitted, parkingPermitted, pauseRecordingPermitted, controlFlowScriptUrl, defaultMusicInQueueMediaFileId."
enum:
- TELEPHONY
- EMAIL
- FAX
- CHAT
- VIDEO
- OTHERS
- SOCIAL_CHANNEL
- WORK_ITEM
example: TELEPHONY
socialChannelType:
type: string
description: 'This can be the following
MESSAGEBIRD
MESSENGER'
enum:
- MESSAGEBIRD
- MESSENGER
- WHATSAPP
- APPLE_BUSINESS_CHAT
- GOOGLE_BUSINESS_MESSAGES
example: MESSENGER
serviceLevelThreshold:
type: integer
format: int32
description: The time in seconds that a customer request can be in a queue before the system flags it as outside the service level. It does not support Social Channel Type.
example: 0
maxActiveContacts:
type: integer
format: int32
description: The maximum number of simultaneous contacts allowed for this queue. It does not support Social Channel Type.
example: 5
maxTimeInQueue:
type: integer
format: int32
description: 'The time in seconds after which the system distributes the queued customer request to the overflow number that you provision for this queue. '
example: 2
defaultMusicInQueueMediaFileId:
type: string
description: "Identifies the default audio file which will be played for calls when they arrive or are waiting in queue. \nThis setting is available only for the Telephony channel type."
example: defaultmusic_on_hold.wav
timezone:
type: string
description: (Optional) Any routing strategy for this queue uses the time zone that you select here.
example: America/New_York
active:
type: boolean
description: Specify whether the queue is active or not active
example: true
outdialCampaignEnabled:
type: boolean
description: Should be specified only for outdial queues; if enabled, then Call Distribution and Queue Routing Type can be specified.
example: true
monitoringPermitted:
type: boolean
description: "Indicates whether or not monitoring is permitted. \nThis setting is available only for the Telephony channel type."
example: true
parkingPermitted:
type: boolean
description: "Indicates whether or not parking is permitted. \nThis setting is available only for the Telephony channel type."
example: true
recordingPermitted:
type: boolean
description: "Indicates whether or not recording is permitted. \nThis setting is available only for the Telephony channel type."
example: true
recordingAllCallsPermitted:
type: boolean
description: "Indicates whether or not recording all calls is permitted. \nThis setting is available only for the Telephony channel type."
example: true
pauseRecordingPermitted:
type: boolean
description: "Indicates whether or not pausing the recording is permitted. \nThis setting is available only for the Telephony channel type."
example: true
recordingPauseDuration:
type: integer
format: int32
description: "The duration in seconds of pause in recording. \nThis setting is available only for the Telephony channel type."
example: 2
controlFlowScriptUrl:
type: string
description: 'The URL for the queue or the default control script of the queue. If you do not use the routing strategy module to configure the control script, the system automatically populates the URL.
This setting is available only for the Telephony channel type.'
example: https://flow-control.produs1.ciscoccservice.com/31f1c57f-4fa1-417b-b5c5-6feb6abea062/royal-enfield
ivrRequeueUrl:
type: string
description: This setting is available only for the Telephony channel type.
example: https://www.youtube.com
overflowNumber:
type: string
description: 'The destination phone number to which the system distributes the customer calls when they exceed the Maximum Time in Queue that you have set in the routing strategy.
This setting is applicable only for the Telephony channel type and it is optional.'
example: 1245677
vendorId:
type: string
description: 'The unique alphanumeric string that maps this queue to the vendor.
This setting is available only for the Telephony channel type and it is optional.'
example: AB123CSDR
routingType:
type: string
description: 'This can be one of the following
LONGEST_AVAILABLE_AGENT
SKILLS_BASED(skillBasedRoutingType is mandatory to define)'
enum:
- LONGEST_AVAILABLE_AGENT
- SKILLS_BASED
- CIRCULAR
- LINEAR
example: SKILLS_BASED
skillBasedRoutingType:
type: string
description: 'This can be the following
LONGEST_AVAILABLE_AGENT
BEST_AVAILABLE_AGENT'
enum:
- LONGEST_AVAILABLE_AGENT
- BEST_AVAILABLE_AGENT
example: BEST_AVAILABLE_AGENT
queueRoutingType:
type: string
description: 'This can be the following
TEAM_BASED
QUEUE_BASED'
enum:
- TEAM_BASED
- SKILL_BASED
- AGENT_BASED
example: TEAM_BASED
queueSkillRequirements:
type: array
items:
$ref: '#/components/schemas/QueueSkillRequirementDTO'
uniqueItems: true
agents:
type: array
description: The list of agents for AgentBased queue
example:
- id: 16c93b13-f1e9-4a4f-bc47-957b9075a56f
ciUserId: 660e0a5a-8230-47d7-ae98-047fb180e1ff
items:
$ref: '#/components/schemas/QueueAgentsDTO'
callDistributionGroups:
type: array
items:
$ref: '#/components/schemas/CallDistributionGroupDTO'
uniqueItems: true
xspVersion:
type: string
description: (Optional) Used to subscribe for recording events.
example: xsp-24.0
maxLength: 80
minLength: 0
subscriptionId:
type: string
description: (Optional) Used to subscribe for recording events.
example: 04d0bdf6-6d6a-4aae-8a8a-71c9152e6478
maxLength: 80
minLength: 0
assistantSkill:
$ref: '#/components/schemas/AssistantSkillMappingDTO'
systemDefault:
type: boolean
description: Indicates whether the created resource is system created or not
example: false
manuallyAssignable:
type: boolean
description: If `true`, the queue can be manually assigned.
example: false
agentsLastUpdatedByUserName:
type: string
description: The name of the user who last modified the agents list.
agentsLastUpdatedByUserEmailPrefix:
type: string
description: The email of the user who last modified the agents list.
agentsLastUpdatedTime:
type: integer
format: int64
description: The date when the agents list was last modified.
example: '2025-03-21T10:30:00Z'
queueLevelSummariesInclusion:
type: string
description: 'Queue level summaries inclusion type. Used only when Queue inclusion for summaries is set to ''Specific Queues'' at the org level AI Assistant->Summaries configuration.
During entity creation(single or bulk), if this parameter is not provided or null, default will be set to ''EXCLUDED''
During entity update(single or bulk), if this parameter is not provided or null, the previous value will be retained.'
example: INCLUDED
queueLevelSentimentAnalysisInclusion:
type: string
description: 'Queue level sentiment analysis inclusion type. Used only when Queue inclusion for sentiment analysis is set to ''Specific Queues'' at the org level AI Assistant->Quality Management configuration.
During entity creation(single or bulk), if this parameter is not provided or null, default will be set to ''EXCLUDED''
During entity update(single or bulk), if this parameter is not provided or null, the previous value will be retained.'
example: INCLUDED
queueLevelPredictedWaitTimeInclusion:
type: string
description: 'Queue level predicted wait time inclusion type. Used only when Queue inclusion for predicted wait time is set to ''Specific Queues'' at the org level AI Assistant->Predicted Wait Time configuration.
During entity creation(single or bulk), if this parameter is not provided or null, default will be set to ''EXCLUDED''
During entity update(single or bulk), if this parameter is not provided or null, the previous value will be retained.'
example: INCLUDED
queueLevelAutoCsatInclusion:
type: string
description: 'Queue level auto CSAT inclusion type. Used only when Queue inclusion for auto CSAT is set to ''Specific Queues'' at the org level AI Assistant->Auto CSAT configuration.
During entity creation(single or bulk), if this parameter is not provided or null, default will be set to ''EXCLUDED''
During entity update(single or bulk), if this parameter is not provided or null, the previous value will be retained.'
example: INCLUDED
queueLevelRealTimeTranscriptionsInclusion:
type: string
description: 'Queue level real time transcriptions inclusion type. Used only when Queue inclusion for real time transcriptions is set to ''Specific Queues'' at the org level AI Assistant->Real Time Transcriptions configuration.
During entity creation(single or bulk), if this parameter is not provided or null, default will be set to ''EXCLUDED''
During entity update(single or bulk), if this parameter is not provided or null, the previous value will be retained.'
example: INCLUDED
personalizedAIRouting:
$ref: '#/components/schemas/QueuePersonalizedAIRoutingDTO'
description: Personalized AI Routing configuration for this queue. Controls AI-based intelligent routing to optimize agent selection based on ML predictions. When enabled, contacts are routed to agents predicted to have the best outcome based on configured KPIs. Requires 'personalized-ai-routing' permission and feature flag enablement. See QueuePersonalizedAIRoutingDTO for state transition requirements.
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.
required:
- active
- callDistributionGroups
- channelType
- checkAgentAvailability
- maxActiveContacts
- maxTimeInQueue
- name
- queueRoutingType
- queueType
- routingType
- serviceLevelThreshold
PaginationLinks:
type: object
properties:
self:
type: string
description: Link to the current page.
example: /v1/callbacks/organization/${orgId}/scheduled-callback?page=1&pageSize=10
first:
type: string
description: Link to the first page.
example: /v1/callbacks/organization/${orgId}/scheduled-callback?page=0&pageSize=10
last:
type: string
description: Link to the last page.
example: /v1/callbacks/organization/${orgId}/scheduled-callback?page=4&pageSize=10
next:
type: string
description: Link to the next page.
example: /v1/callbacks/organization/${orgId}/scheduled-callback?page=2&pageSize=10
prev:
type: string
description: Link to the previous page.
example: /v1/callbacks/organization/${orgId}/scheduled-callback?page=0&pageSize=10
required:
- self
QueueSkillRequirementDTO:
type: object
description: Skill requirement for the queue
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
skillId:
type: string
description: Skill ID reference
example: af9eecc5-0472-4549-9a83-2afdae0d4ba0
minLength: 1
skillName:
type: string
description: Indicates the name of the skill. Once created, name cannot be modified.
example: German Speaking
skillType:
type: string
description: 'This can be of the following types
PROFICIENCY: id = 0
BOOLEAN: id = 1
TEXT: id = 2
ENUM: id = 3
Once created, skillType cannot be modified.
'
example: BOOLEAN
condition:
type: string
description: Indicates a value that represents a skill the agent has.
example: IS_NOT
skillValue:
type: string
description: A short textual description that represents a skill the agent has.
example: Credit card SME
minLength: 1
weight:
type: integer
format: int32
description: Weight for proficiency skill requirement
example: 100
maximum: 1000
dynamicSkill:
type: boolean
description: Indicates whether the skill is a dynamic skill or not. Default value is false.
example: false
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.
required:
- condition
- skillId
- skillValue
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
CSQGroupedAssistantSkillResponseDTO:
type: object
description: Queue mapping summary per Assistant Skill
properties:
assistantSkillId:
type: string
description: ID of Assistant Skill in AI Studio
example: af9eecc5-0472-4549-9a83-2afdae0d4ba0
associatedQueueCount:
type: integer
format: int64
description: Number of queues mapped to this Assistant Skill ID
lastAssistantSkillUpdatedTime:
type: integer
format: int64
description: Last updated time Assistant Skill mapping i.e. timestamp corresponding to most recently added queue mapping
CallDistributionGroupDTO:
type: object
properties:
agentGroups:
type: array
items:
$ref: '#/components/schemas/AgentGroupDTO'
uniqueItems: true
order:
type: integer
format: int32
description: The order of this call distribution group.
example: 1
duration:
type: integer
format: int32
default: 0
description: (Optional)The duration in seconds after which a contact in queue will be distributed to this group.
example: 2
ManuallyAssignableQueuesRequest:
type: object
description: Request body for fetching manually assignable Contact Service Queues.
properties:
agentId:
type: string
description: The ID of the agent to check queue assignments for.
teamId:
type: string
description: The ID of the team to check queue assignments for.
MetaDataPagedInfo:
type: object
properties:
orgid:
type: string
description: ID of the contact center organization. This field is required for all bulk save operations.
example: af9eecc5-0472-4549-9a83-2afdae0d4ba0
page:
type: integer
format: int32
description: Current page number.
example: 1
pageSize:
type: integer
format: int32
description: Page size for current data set.
example: 20
totalPages:
type: integer
format: int32
description: Number of pages.
example: 5
totalRecords:
type: integer
format: int64
description: Total number of items.
example: 100
links:
type: object
$ref: '#/components/schemas/PaginationLinks'
additionalProperties:
type: string
ContactServiceQueueBulkExportDTO:
type: object
description: DTO for bulk export of Contact Service Queue data.
properties:
name:
type: string
description: Name of the Contact Service Queue.
description:
type: string
description: A short description of the queue.
type:
type: string
description: The queue type, such as INBOUND or OUTBOUND.
channelType:
type: string
description: The channel type of the queue.
routingType:
type: string
description: The routing type for this queue.
monitoringPermitted:
type: boolean
description: Indicates whether monitoring is permitted.
parkingPermitted:
type: boolean
description: Indicates whether parking is permitted.
recordingPermitted:
type: boolean
description: Indicates whether recording is permitted.
recordingAllCallsPermitted:
type: boolean
description: Indicates whether recording all calls is permitted.
pauseRecordingPermitted:
type: boolean
description: Indicates whether pausing the recording is permitted.
recordingPauseDuration:
type: integer
format: int32
description: The duration in seconds of pause in recording.
maxTimeInQueue:
type: integer
format: int32
description: The time in seconds after which the queued request is distributed to the overflow number.
defaultMusicInQueueMediaFile:
type: string
description: The default audio file played for calls when they arrive or are waiting in queue.
serviceLevelThreshold:
type: string
description: The time in seconds before the system flags a request as outside the service level.
timezone:
type: string
description: The time zone used by routing strategies for this queue.
imiOrgType:
type: string
description: The IMI organization type associated with this queue.
skillBasedRoutingType:
type: string
description: The skill-based routing type for this queue.
outdialCampaignEnabled:
type: boolean
description: Indicates whether outdial campaign is enabled.
queueRoutingType:
type: string
description: The queue routing type.
callDistributionGroups:
type: array
description: The call distribution groups configured for this queue.
items:
$ref: '#/components/schemas/CallDistributionGroupBulkExportDTO'
uniqueItems: true
queueSkillRequirements:
type: array
description: The skill requirements configured for this queue.
items:
$ref: '#/components/schemas/QueueSkillRequirementDTO'
uniqueItems: true
agents:
type: array
description: The list of agent IDs assigned to this queue.
items:
type: string
manuallyAssignable:
type: boolean
description: Indicates whether the queue can be manually assigned.
queueLevelSummariesInclusion:
type: string
description: Queue level summaries inclusion type.
enum:
- NOT_APPLICABLE
- EXCLUDED
- INCLUDED
queueLevelSentimentAnalysisInclusion:
type: string
description: Queue level sentiment analysis inclusion type.
enum:
- NOT_APPLICABLE
- EXCLUDED
- INCLUDED
queueLevelPredictedWaitTimeInclusion:
type: string
description: Queue level predicted wait time inclusion type.
enum:
- NOT_APPLICABLE
- EXCLUDED
- INCLUDED
queueLevelAutoCsatInclusion:
type: string
description: Queue level auto CSAT inclusion type.
enum:
- NOT_APPLICABLE
- EXCLUDED
- INCLUDED
queueLevelRealTimeTranscriptionsInclusion:
type: string
description: Queue level real time transcriptions inclusion type.
enum:
- NOT_APPLICABLE
- EXCLUDED
- INCLUDED
assistantSkill:
$ref: '#/components/schemas/AssistantSkillMappingDTO'
description: The assistant skill mapping for this queue.
SkillBasedCSQDTO:
type: object
description: Skill-based Contact Service Queue data transfer 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.
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
channelType:
type: string
description: The channel type of the queue.
name:
type: string
description: Name of the Contact Service Queue.
skillScore:
type: integer
format: int32
description: The skill score for matching this queue.
qsrType:
type: string
description: The queue skill requirement type.
dynamicSkillScore:
type: integer
format: int32
description: The dynamic skill score for matching this queue.
skillProfileSkillsMatch:
type: boolean
description: Indicates whether the skill profile skills match.
dynamicSkillsMatch:
type: boolean
description: Indicates whether the dynamic skills match.
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.
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
BulkExportDTOContactServiceQueueBulkExportDTO:
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/ContactServiceQueueBulkExportDTO'
QueuePersonalizedAIRoutingDTO:
type: object
description: Queue-level Personalized AI Routing configuration. Enables intelligent agent routing based on AI/ML predictions.
properties:
aiRoutingMode:
type: string
default: NONE
description: 'AI Routing mode. Valid transitions: NONE → EVALUATION; EVALUATION → ACTIVE or NONE; ACTIVE → NONE. NONE: AI routing disabled (default). EVALUATION: Shadow mode - AI predictions are generated but not used for routing (for testing/validation). ACTIVE: AI routing enabled - contacts are routed based on AI predictions.'
enum:
- NONE
- EVALUATION
- ACTIVE
example: EVALUATION
aiRoutingKPIId:
type: string
description: AI Routing KPI ID - the performance metric used by AI to optimize routing decisions. This should reference a valid KPI configured in the AI routing system. Required when aiRoutingMode is EVALUATION or ACTIVE.
example: 63beec53-8a61-489f-afc6-bb03c8c73834
evaluationModeStartTime:
type: integer
format: int64
description: Timestamp (epoch milliseconds) when EVALUATION mode was activated. Automatically set by the system when transitioning from NONE to EVALUATION. Used to track evaluation duration and readiness for ACTIVE mode transition.
example: 1730269619000
readOnly: true
QueueAgentsDTO:
type: object
properties:
id:
type: string
description: Id of an agent in WxCC
example: b0503c7f-d13c-4d74-9eb5-64f3c818b8c7
ciUserId:
type: string
description: Id of an agent in Common Identity
example: c71876ae-ddfa-4049-9a1b-298535152578
required:
- id
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.
FieldRequestBody:
type: object
description: Request body containing field references for delete operations.
properties:
references:
type: object
description: A map of reference field names to their values.
additionalProperties:
type: string
ResponseEnvelopeRoutingBasedQueueDTO:
type: object
description: Response envelope containing routing-based Contact Service Queue data.
properties:
meta:
type: object
description: Metadata about the response.
additionalProperties: {}
data:
type: array
description: List of routing-based Contact Service Queue items.
items:
$ref: '#/components/schemas/RoutingBasedQueueDTO'
CallDistributionGroupBulkExportDTO:
type: object
description: Call distribution group data for bulk export.
properties:
agentGroups:
type: array
description: The agent groups in this call distribution group.
items:
$ref: '#/components/schemas/AgentGroupsBulkExportDTO'
uniqueItems: true
order:
type: integer
format: int32
description: The order of this call distribution group.
duration:
type: integer
format: int32
description: The duration in seconds after which a contact in queue will be distributed to this group.
CSQGroupedAssistantSkillRequestDTO:
type: object
description: Request payload for fetching queue mapping summary grouped by Assistant Skill
properties:
assistantSkillIds:
type: array
description: List of AssistantSkill ids to fetch. If property is unspecified or set to null, then all assistantSkillIds mapped will be returned.
example:
- f53c8b54-46ca-43f6-ba05-08426a46e23d
- a53c8b54-46ca-43f6-ba05-08426a46e23f
items:
type: string
uniqueItems: true
BulkRequestDTOContactServiceQueueDTO:
type: object
description: Bulk request DTO containing a list of Contact Service Queue items for bulk operations.
properties:
items:
type: array
description: List of items in the bulk request.
items:
$ref: '#/components/schemas/BulkRequestItemDTOContactServiceQueueDTO'
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'
ResponseEnvelopeSkillBasedCSQDTO:
type: object
description: Response envelope containing skill-based Contact Service Queue data.
properties:
meta:
type: object
description: Metadata about the response.
additionalProperties: {}
data:
type: array
description: List of skill-based Contact Service Queue items.
items:
$ref: '#/components/schemas/SkillBasedCSQDTO'
AssistantSkillMappingDTO:
type: object
properties:
assistantSkillId:
type: string
description: Id of an Assistant Skill mapped to the Contact Service Queue
example: af9eecc5-0472-4549-9a83-2afdae0d4ba0
assistantSkillUpdatedTime:
type: integer
format: int64
description: Time(in epoch milliseconds) when assistant skill mapping was last updated.
example: 1617536244000
readOnly: true
BulkResponseDTO:
type: object
properties:
items:
type: array
items:
$ref: '#/components/schemas/BulkResponseItemDTO'
ReassignAgentsRequestDTO:
type: object
properties:
add:
type: array
items:
type: string
uniqueItems: true
remove:
type: array
items:
type: string
uniqueItems: true
BulkRequestItemDTOContactServiceQueueDTO:
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/ContactServiceQueueDTO'
description: The Contact Service Queue data for this bulk request item.
requestAction:
type: string
description: Identifier for action type. Possible values are `SAVE` and `DELETE`.
example: SAVE
RoutingBasedQueueDTO:
type: object
description: Routing-based Contact Service Queue data transfer 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.
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
name:
type: string
description: Name of the Contact Service Queue.
routingPattern:
type: string
description: The routing pattern for this queue.
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.
AgentGroupDTO:
type: object
properties:
teamId:
type: string
description: ID of a team
example: 93912f11-6017-404b-bf14-5331890b1797
ResponseMetaEnvelopeContactServiceQueueDTOMetaDataPagedInfo:
type: object
properties:
meta:
$ref: '#/components/schemas/MetaDataPagedInfo'
data:
type: array
items:
$ref: '#/components/schemas/ContactServiceQueueDTO'
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'
ContactServiceQueueDTOList:
type: object
description: Contact Service Queue list data transfer object with condensed fields for list operations.
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
name:
type: string
description: Name of the Contact Service Queue
example: Queue-1
description:
type: string
description: (Optional) A short description of the queue.
example: Queue created by system
queueType:
type: string
description: 'This can be the following
INBOUND
OUTBOUND'
enum:
- INBOUND
- OUTBOUND
example: INBOUND
checkAgentAvailability:
type: boolean
description: This setting specifies whether the system can exclude teams with no logged in agents for the relevant routing strategies. It does not support Social Channel Type.
example: true
channelType:
type: string
description: "Setting to indicate the channel type. Use uppercase. Supported channel types are: \n\n TELEPHONY, EMAIL, SOCIAL_CHANNEL, and CHAT. \n\nFor TELEPHONY channelType, the following fields are mandatory - recordingPermitted, ivrRequeueUrl, recordingAllCallsPermitted, monitoringPermitted, parkingPermitted, pauseRecordingPermitted, controlFlowScriptUrl, defaultMusicInQueueMediaFileId."
enum:
- TELEPHONY
- EMAIL
- FAX
- CHAT
- VIDEO
- OTHERS
- SOCIAL_CHANNEL
- WORK_ITEM
example: TELEPHONY
socialChannelType:
type: string
description: 'This can be the following
MESSAGEBIRD
MESSENGER'
enum:
- MESSAGEBIRD
- MESSENGER
- WHATSAPP
- APPLE_BUSINESS_CHAT
- GOOGLE_BUSINESS_MESSAGES
example: MESSENGER
serviceLevelThreshold:
type: integer
format: int32
description: The time in seconds that a customer request can be in a queue before the system flags it as outside the service level. It does not support Social Channel Type.
example: 0
maxActiveContacts:
type: integer
format: int32
description: The maximum number of simultaneous contacts allowed for this queue. It does not support Social Channel Type.
example: 5
maxTimeInQueue:
type: integer
format: int32
description: 'The time in seconds after which the system distributes the queued customer request to the overflow number that you provision for this queue. '
example: 2
defaultMusicInQueueMediaFileId:
type: string
description: "Identifies the default audio file which will be played for calls when they arrive or are waiting in queue. \nThis setting is available only for the Telephony channel type."
example: defaultmusic_on_hold.wav
timezone:
type: string
description: (Optional) Any routing strategy for this queue uses the time zone that you select here.
example: America/New_York
active:
type: boolean
description: Specify whether the queue is active or not active
example: true
outdialCampaignEnabled:
type: boolean
description: Should be specified only for outdial queues; if enabled, then Call Distribution and Queue Routing Type can be specified.
example: true
monitoringPermitted:
type: boolean
description: "Indicates whether or not monitoring is permitted. \nThis setting is available only for the Telephony channel type."
example: true
parkingPermitted:
type: boolean
description: "Indicates whether or not parking is permitted. \nThis setting is available only for the Telephony channel type."
example: true
recordingPermitted:
type: boolean
description: "Indicates whether or not recording is permitted. \nThis setting is available only for the Telephony channel type."
example: true
recordingAllCallsPermitted:
type: boolean
description: "Indicates whether or not recording all calls is permitted. \nThis setting is available only for the Telephony channel type."
example: true
pauseRecordingPermitted:
type: boolean
description: "Indicates whether or not pausing the recording is permitted. \nThis setting is available only for the Telephony channel type."
example: true
recordingPauseDuration:
type: integer
format: int32
description: "The duration in seconds of pause in recording. \nThis setting is available only for the Telephony channel type."
example: 2
controlFlowScriptUrl:
type: string
description: 'The URL for the queue or the default control script of the queue. If you do not use the routing strategy module to configure the control script, the system automatically populates the URL.
This setting is available only for the Telephony channel type.'
example: https://flow-control.produs1.ciscoccservice.com/31f1c57f-4fa1-417b-b5c5-6feb6abea062/royal-enfield
ivrRequeueUrl:
type: string
description: This setting is available only for the Telephony channel type.
example: https://www.youtube.com
overflowNumber:
type: string
description: 'The destination phone number to which the system distributes the customer calls when they exceed the Maximum Time in Queue that you have set in the routing strategy.
This setting is applicable only for the Telephony channel type and it is optional.'
example: '1245677'
vendorId:
type: string
description: 'The unique alphanumeric string that maps this queue to the vendor.
This setting is available only for the Telephony channel type and it is optional.'
example: AB123CSDR
routingType:
type: string
description: 'This can be one of the following
LONGEST_AVAILABLE_AGENT
SKILLS_BASED(skillBasedRoutingType is mandatory to define)'
enum:
- LONGEST_AVAILABLE_AGENT
- SKILLS_BASED
- CIRCULAR
- LINEAR
example: SKILLS_BASED
skillBasedRoutingType:
type: string
description: 'This can be the following
LONGEST_AVAILABLE_AGENT
BEST_AVAILABLE_AGENT'
enum:
- LONGEST_AVAILABLE_AGENT
- BEST_AVAILABLE_AGENT
example: BEST_AVAILABLE_AGENT
queueRoutingType:
type: string
description: 'This can be the following
TEAM_BASED
QUEUE_BASED'
enum:
- TEAM_BASED
- SKILL_BASED
- AGENT_BASED
example: TEAM_BASED
xspVersion:
type: string
description: (Optional) Used to subscribe for recording events.
example: xsp-24.0
maxLength: 80
minLength: 0
subscriptionId:
type: string
description: (Optional) Used to subscribe for recording events.
example: 04d0bdf6-6d6a-4aae-8a8a-71c9152e6478
maxLength: 80
minLength: 0
assistantSkill:
$ref: '#/components/schemas/AssistantSkillMappingDTO'
description: The assistant skill mapping for this queue.
systemDefault:
type: boolean
description: Indicates whether the created resource is system created or not
example: false
manuallyAssignable:
type: boolean
description: If `true`, the queue can be manually assigned.
example: false
agentsLastUpdatedByUserName:
type: string
description: The name of the user who last modified the agents list.
agentsLastUpdatedByUserEmailPrefix:
type: string
description: The email of the user who last modified the agents list.
agentsLastUpdatedTime:
type: integer
format: int64
description: The date when the agents list was last modified.
example: 1742556600000
queueLevelSummariesInclusion:
type: string
description: 'Queue level summaries inclusion type. Used only when Queue inclusion for summaries is set to ''Specific Queues'' at the org level AI Assistant->Summaries configuration.
During entity creation(single or bulk), if this parameter is not provided or null, default will be set to ''EXCLUDED''
During entity update(single or bulk), if this parameter is not provided or null, the previous value will be retained.'
example: INCLUDED
queueLevelSentimentAnalysisInclusion:
type: string
description: 'Queue level sentiment analysis inclusion type. Used only when Queue inclusion for sentiment analysis is set to ''Specific Queues'' at the org level AI Assistant->Quality Management configuration.
During entity creation(single or bulk), if this parameter is not provided or null, default will be set to ''EXCLUDED''
During entity update(single or bulk), if this parameter is not provided or null, the previous value will be retained.'
example: INCLUDED
queueLevelPredictedWaitTimeInclusion:
type: string
description: 'Queue level predicted wait time inclusion type. Used only when Queue inclusion for predicted wait time is set to ''Specific Queues'' at the org level AI Assistant->Predicted Wait Time configuration.
During entity creation(single or bulk), if this parameter is not provided or null, default will be set to ''EXCLUDED''
During entity update(single or bulk), if this parameter is not provided or null, the previous value will be retained.'
example: INCLUDED
queueLevelAutoCsatInclusion:
type: string
description: 'Queue level auto CSAT inclusion type. Used only when Queue inclusion for auto CSAT is set to ''Specific Queues'' at the org level AI Assistant->Auto CSAT configuration.
During entity creation(single or bulk), if this parameter is not provided or null, default will be set to ''EXCLUDED''
During entity update(single or bulk), if this parameter is not provided or null, the previous value will be retained.'
example: INCLUDED
queueLevelRealTimeTranscriptionsInclusion:
type: string
description: 'Queue level real time transcriptions inclusion type. Used only when Queue inclusion for real time transcriptions is set to ''Specific Queues'' at the org level AI Assistant->Real Time Transcriptions configuration.
During entity creation(single or bulk), if this parameter is not provided or null, default will be set to ''EXCLUDED''
During entity update(single or bulk), if this parameter is not provided or null, the previous value will be retained.'
example: INCLUDED
personalizedAIRouting:
$ref: '#/components/schemas/QueuePersonalizedAIRoutingDTO'
description: Personalized AI Routing configuration for this queue. Controls AI-based intelligent routing to optimize agent selection based on ML predictions. When enabled, contacts are routed to agents predicted to have the best outcome based on configured KPIs. Requires 'personalized-ai-routing' permission and feature flag enablement. See QueuePersonalizedAIRoutingDTO for state transition requirements.
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.
AgentGroupsBulkExportDTO:
type: object
description: Agent group data for bulk export.
properties:
teamName:
type: string
description: The name of the team in this agent group.
siteName:
type: string
description: The name of the site associated with this agent group.
MappedCSQDTO:
type: object
description: Mapped Contact Service Queue data transfer 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.
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
channelType:
type: string
description: The channel type of the queue.
name:
type: string
description: Name of the Contact Service Queue.
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.
DynamicSkillDTO:
type: object
description: Dynamic skill data transfer object for skill-based queue filtering.
properties:
skillId:
type: string
description: The ID of the skill.
textValue:
type: string
description: The text value for a text-type skill.
booleanValue:
type: boolean
description: The boolean value for a boolean-type skill.
proficiencyValue:
type: integer
format: int32
description: The proficiency value for a proficiency-type skill.
enumSkillValues:
type: array
description: The set of enum values for an enum-type skill.
items:
type: string
uniqueItems: true
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
ResponseEnvelopeCSQGroupedAssistantSkillResponseDTO:
type: object
properties:
meta:
type: object
additionalProperties: {}
data:
type: array
items:
$ref: '#/components/schemas/CSQGroupedAssistantSkillResponseDTO'
MetaDataPagedCSQ:
type: object
properties:
orgid:
type: string
description: ID of the contact center organization. This field is required for all bulk save operations.
example: af9eecc5-0472-4549-9a83-2afdae0d4ba0
page:
type: integer
format: int32
description: Current page number.
example: 1
pageSize:
type: integer
format: int32
description: Page size for current data set.
example: 20
totalPages:
type: integer
format: int32
description: Number of pages.
example: 5
totalRecords:
type: integer
format: int64
description: Total number of items.
example: 100
links:
type: object
description: Map of pagination links.
$ref: '#/components/schemas/PaginationLinks'
additionalProperties:
type: string
actualSummariesInclusionCount:
type: integer
format: int64
description: Indicates the actual number of queues included for AI assistant-generated summaries in a given organization, including queues that are access-restricted for the user requesting the data.
example: 100
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