Maintenance Notice - PDF Generation
Dynamic PDF generation for web-based content is temporarily unavailable. This maintenance affects dynamic PDF files that are generated from either the HTML-based page or manual that you are viewing. Links that normally allow this functionality have been hidden, and will reappear as soon as the feature is restored.

Note: Access to static files, including PDF files that are not dynamically generated from our web-based content, is unaffected.

Jump to: navigation, search

Merge Extension Data

  • PUT /genesys/1/cs/services/${service_id}/extensions/${ext_name}/merge
  • PUT /genesys/1/cs/services/${service_id}/states/${state_id}/extensions/${ext_name}/merge
  • PUT /genesys/1/cs/services/${service_id}/tasks/${task_id}/extensions/${ext_name}/merge

Added in: 8.5.110


Updates an extension with the provided key-value pair or creates a new one if the extension does not exist in the given Service, State, or Task. If the extension exists, the system will add the new key-value pair without overwriting the extension's content.

Use this API to update extensions without reading them first and then calling one of the regular update Update Service Extension, Update State Extension, and Update Task Extension APIs.


Merge or create Service, State, Task extension data
  • PUT /genesys/1/cs/services/${service_id}/extensions/${ext_name}/merge
  • PUT /genesys/1/cs/services/${service_id}/states/${state_id}/extensions/${ext_name}/merge
  • PUT /genesys/1/cs/services/${service_id}/tasks/${task_id}/extensions/${ext_name}/merge
Field Name   Type   Mandatory Description
URI Parameters
${service_id} Integer yes The ID of the service.
${state_id} Integer yes The ID of the state.
${task_id} Integer yes The ID of the task.
${ext_name} String yes The extension name.
Body Parameters
<extension> or <extension>[] JSON yes The attached data to merge as key-value pairs or as an array of key-value pairs.

You can merge maps, such as:

"${ext_name}": { "offer_name":"VIP credit card black ed.", "type":9, "comments":"proposed to all client" }

This query will not work with extension lists such as:

{ext_name}": [
{ "offer_name":"VIP credit card black ed.", "type":9, "comments":"proposed to all client" },
{ "offer_name":"VIP credit card black ed.", "type":9, "comments":"proposed to all client" }


The Context Management Service API answers with HTTP codes for every request. The following table shows the correct response for a successful request. See HTTP Response Codes and Errors for further details on the possible codes that this operation can return.

200 OK


Operation to update a service extension
In this scenario, the first PUT request creates an extension, then the POST request merges its extension data with new data, then the GET request queries the service.

PUT /genesys/1/cs/services/8389/extensions/agent{
    "agentID": 2025,
    "score": 85,
    "extensions": [
    "location": "Toronto"

PUT /genesys/1/cs/services/8389/extensions/agent/merge
{ "extensions": [ "228144", "228444" ], "location": "Markham"}


GET /genesys/1/cs/services/8389?extensions=agent 
HTTP 200 OK{
    "service_id": 3005,
    "service_type": 100,
    "est_duration": 300,
    "agent": {
        "agentID": 2025,
        "score": 85,
        "extensions": [
"location": "Markham"
This page was last edited on July 7, 2017, at 11:57.


Comment on this article:

blog comments powered by Disqus