Media Routing Domain API

A media routing domain is a collection of skill groups associated with a common media class. It is used to organize how requests for different media are routed.

Use the Media Routing Domain (MRD) API to list the MRDs currently defined in the database, define new MRDs, and view, edit, and delete existing MRDs.

The built-in Cisco_Voice MRD and legacyMultichannel MRDs are read-only; they cannot be created, updated, or deleted. You can perform all API operations on multichannel MRDs.

URL

https://<server>/unifiedconfig/config/mediaroutingdomain

Operations

Parameters

Search and Sort Values

The following table shows the parameters that are searched and the parameters that are sortable.

Search parameters Sort parameters
  • name
  • description
  • id
  • name (default)
  • description
  • id
  • interruptible
  • maxTasksInQueue
  • maxTaskDuration
  • maxTimeInQueue
  • serviceLevelThreshold
  • taskLife
  • taskStartTimeout

See Search and Sort.

Advanced search parameters

You can perform a nonVoiceOnly search on the Media Routing Domain API:
  • nonVoiceOnly: Set this attribute to true in the search query parameter to make the API return only media routing domains other than the Cisco_Voice MRD. For example, q=nonVoiceOnly:true.

Example Get Response

 <mediaRoutingDomains>
   <mediaRoutingDomain>
      <changeStamp>0</changeStamp>
      <refURL>/unifiedconfig/config/mediaroutingdomain/5001</refURL>
      <description>Media channel for routing Chat tasks</description>
						<id>5001</id>
						<type>multichannel</type>
      <interruptible>false</interruptible>
						<taskLife>1200</taskLife>
						<taskStartTimeout>30</taskStartTimeout>
						<maxTaskDuration>28800</maxTaskDuration>
      <maxTasksInQueue>1000</maxTasksInQueue>
      <maxTimeInQueue>1000</maxTimeInQueue>
      <name>Chat_Task_MRD</name>
      <serviceLevelThreshold>30</serviceLevelThreshold>
   </mediaRoutingDomain>
   <mediaRoutingDomain>
      <changeStamp>0</changeStamp>
      <refURL>/unifiedconfig/config/mediaroutingdomain/1</refURL>
      <description>Default Media Routing Domain for Cisco_Voice</description>
      <id>1</id>
						<type>voice</type>
      <interruptible>false</interruptible>
						<taskLife>1200</taskLife>
						<taskStartTimeout>30</taskStartTimeout>
						<maxTaskDuration>28800</maxTaskDuration>
      <name>Cisco_Voice</name>
      <serviceLevelThreshold>30</serviceLevelThreshold>
    </mediaRoutingDomain>
  </mediaRoutingDomains>