Difference between revisions of "PEC-Developer/Current/WebAPIs/UDM Data-download"

From Genesys Documentation
Jump to: navigation, search
 
Line 5: Line 5:
  
 
== Base path: /udm ==
 
== Base path: /udm ==
−
 
 
=== Version 10 API Requests ===
 
=== Version 10 API Requests ===
  
Line 23: Line 22:
 
| x-api-key
 
| x-api-key
 
|  
 
|  
 +
| API key provided by Genesys. UDM deployments are accessed through GAPI-based URLs, for example, <nowiki>https://gapi-use1.genesyscloud.com/udm</nowiki>
 +
| header
 +
| string
 
|  
 
|  
 +
|-
 +
| Authorization
 +
|
 +
| Bearer token in the format, '''Authorization: Bearer <GAuth token>'''. See details about {{Link-AnywhereElse|product=PEC-Developer|version=Current|manual=WebAPIs|topic=Authentication|display text=GAuth token}}.
 
| header
 
| header
 
| string
 
| string
−
|  
+
| Yes
 
|}
 
|}
 
<div class="web-api-section-heading">Responses</div>
 
<div class="web-api-section-heading">Responses</div>
Line 69: Line 75:
 
-H "x-api-key: your_API_key"
 
-H "x-api-key: your_API_key"
 
-H "Content-Type: application/json"
 
-H "Content-Type: application/json"
−
 
+
-H "Authorization: Bearer eyJhbGciOiJSU...afA1Q"
 
"https://api-demo.com/udm/v10/cipher?"
 
"https://api-demo.com/udm/v10/cipher?"
 
</source>
 
</source>
Line 90: Line 96:
 
| x-api-key
 
| x-api-key
 
|  
 
|  
−
|  
+
| API key provided by Genesys. UDM deployments are accessed through GAPI-based URLs, for example, <nowiki>https://gapi-use1.genesyscloud.com/udm</nowiki>
 
| header
 
| header
 
| string
 
| string
Line 108: Line 114:
 
| file
 
| file
 
| true
 
| true
 +
|-
 +
| Authorization
 +
|
 +
| Bearer token in the format, '''Authorization: Bearer <GAuth token>'''. See details about {{Link-AnywhereElse|product=PEC-Developer|version=Current|manual=WebAPIs|topic=Authentication|display text=GAuth token}}.
 +
| header
 +
| string
 +
| Yes
 
|}
 
|}
 
<div class="web-api-section-heading">Responses</div>
 
<div class="web-api-section-heading">Responses</div>
Line 132: Line 145:
 
-H "x-api-key: your_API_key"
 
-H "x-api-key: your_API_key"
 
-H "Content-Type: application/json"
 
-H "Content-Type: application/json"
−
 
+
-H "Authorization: Bearer eyJhbGciOiJSU...afA1Q"
 
"https://api-demo.com/udm/v10/cipher/{certificatefilename}?"
 
"https://api-demo.com/udm/v10/cipher/{certificatefilename}?"
 
</source>
 
</source>
Line 156: Line 169:
 
| string
 
| string
 
|  
 
|  
 +
|-
 +
| Authorization
 +
|
 +
| Bearer token in the format, '''Authorization: Bearer <GAuth token>'''. See details about {{Link-AnywhereElse|product=PEC-Developer|version=Current|manual=WebAPIs|topic=Authentication|display text=GAuth token}}.
 +
| header
 +
| string
 +
| Yes
 
|}
 
|}
 
<div class="web-api-section-heading">Responses</div>
 
<div class="web-api-section-heading">Responses</div>
Line 175: Line 195:
 
-H "x-api-key: your_API_key"
 
-H "x-api-key: your_API_key"
 
-H "Content-Type: application/json"
 
-H "Content-Type: application/json"
−
 
+
-H "Authorization: Bearer eyJhbGciOiJSU...afA1Q"
 
"https://api-demo.com/udm/v10/data/attributes?entities=string"
 
"https://api-demo.com/udm/v10/data/attributes?entities=string"
 
</source>
 
</source>
Line 195: Line 215:
 
| x-api-key
 
| x-api-key
 
|  
 
|  
 +
| API key provided by Genesys. UDM deployments are accessed through GAPI-based URLs, for example, <nowiki>https://gapi-use1.genesyscloud.com/udm</nowiki>
 +
| header
 +
| string
 +
|
 +
|-
 +
| Authorization
 
|  
 
|  
 +
| Bearer token in the format, '''Authorization: Bearer <GAuth token>'''. See details about {{Link-AnywhereElse|product=PEC-Developer|version=Current|manual=WebAPIs|topic=Authentication|display text=GAuth token}}.
 
| header
 
| header
 
| string
 
| string
−
|  
+
| Yes
 
|}
 
|}
 
<div class="web-api-section-heading">Responses</div>
 
<div class="web-api-section-heading">Responses</div>
Line 218: Line 245:
 
-H "x-api-key: your_API_key"
 
-H "x-api-key: your_API_key"
 
-H "Content-Type: application/json"
 
-H "Content-Type: application/json"
−
 
+
-H "Authorization: Bearer eyJhbGciOiJSU...afA1Q"
 
"https://api-demo.com/udm/v10/data/job-statuses?"
 
"https://api-demo.com/udm/v10/data/job-statuses?"
 
</source>
 
</source>
Line 238: Line 265:
 
| x-api-key
 
| x-api-key
 
|  
 
|  
 +
| API key provided by Genesys. UDM deployments are accessed through GAPI-based URLs, for example, <nowiki>https://gapi-use1.genesyscloud.com/udm</nowiki>
 +
| header
 +
| string
 +
|
 +
|-
 +
| Authorization
 
|  
 
|  
 +
| Bearer token in the format, '''Authorization: Bearer <GAuth token>'''. See details about {{Link-AnywhereElse|product=PEC-Developer|version=Current|manual=WebAPIs|topic=Authentication|display text=GAuth token}}.
 
| header
 
| header
 
| string
 
| string
−
|  
+
| Yes
 
|}
 
|}
 
<div class="web-api-section-heading">Responses</div>
 
<div class="web-api-section-heading">Responses</div>
Line 264: Line 298:
 
-H "x-api-key: your_API_key"
 
-H "x-api-key: your_API_key"
 
-H "Content-Type: application/json"
 
-H "Content-Type: application/json"
−
 
+
-H "Authorization: Bearer eyJhbGciOiJSU...afA1Q"
 
"https://api-demo.com/udm/v10/data/sources?"
 
"https://api-demo.com/udm/v10/data/sources?"
 
</source>
 
</source>
Line 284: Line 318:
 
| x-api-key
 
| x-api-key
 
|  
 
|  
−
|  
+
| API key provided by Genesys. UDM deployments are accessed through GAPI-based URLs, for example, <nowiki>https://gapi-use1.genesyscloud.com/udm</nowiki>
 
| header
 
| header
 
| string
 
| string
Line 302: Line 336:
 
| string
 
| string
 
|  
 
|  
−
|}
+
|-
 +
| Authorization
 +
|
 +
| Bearer token in the format, '''Authorization: Bearer <GAuth token>'''. See details about {{Link-AnywhereElse|product=PEC-Developer|version=Current|manual=WebAPIs|topic=Authentication|display text=GAuth token}}.
 +
| header
 +
| string
 +
| Yes
 +
|}
 
<div class="web-api-section-heading">Responses</div>
 
<div class="web-api-section-heading">Responses</div>
 
{| class="web-api-responses-table"
 
{| class="web-api-responses-table"
Line 327: Line 368:
 
-H "x-api-key: your_API_key"
 
-H "x-api-key: your_API_key"
 
-H "Content-Type: application/json"
 
-H "Content-Type: application/json"
−
 
+
-H "Authorization: Bearer eyJhbGciOiJSU...afA1Q"
 
"https://api-demo.com/udm/v10/data/sub-types?dataType=string&source=string"
 
"https://api-demo.com/udm/v10/data/sub-types?dataType=string&source=string"
 
</source>
 
</source>
Line 347: Line 388:
 
| x-api-key
 
| x-api-key
 
|  
 
|  
−
|  
+
| API key provided by Genesys. UDM deployments are accessed through GAPI-based URLs, for example, <nowiki>https://gapi-use1.genesyscloud.com/udm</nowiki>
 
| header
 
| header
 
| string
 
| string
Line 358: Line 399:
 
| string
 
| string
 
|  
 
|  
 +
|-
 +
| Authorization
 +
|
 +
| Bearer token in the format, '''Authorization: Bearer <GAuth token>'''. See details about {{Link-AnywhereElse|product=PEC-Developer|version=Current|manual=WebAPIs|topic=Authentication|display text=GAuth token}}.
 +
| header
 +
| string
 +
| Yes
 
|}
 
|}
 
<div class="web-api-section-heading">Responses</div>
 
<div class="web-api-section-heading">Responses</div>
Line 380: Line 428:
 
-H "x-api-key: your_API_key"
 
-H "x-api-key: your_API_key"
 
-H "Content-Type: application/json"
 
-H "Content-Type: application/json"
−
 
+
-H "Authorization: Bearer eyJhbGciOiJSU...afA1Q"
 
"https://api-demo.com/udm/v10/data/types?source=string"
 
"https://api-demo.com/udm/v10/data/types?source=string"
 
</source>
 
</source>
Line 400: Line 448:
 
| x-api-key
 
| x-api-key
 
|  
 
|  
−
|  
+
| API key provided by Genesys. UDM deployments are accessed through GAPI-based URLs, for example, <nowiki>https://gapi-use1.genesyscloud.com/udm</nowiki>
 
| header
 
| header
 
| string
 
| string
Line 481: Line 529:
 
| string
 
| string
 
|  
 
|  
 +
|-
 +
| Authorization
 +
|
 +
| Bearer token in the format, '''Authorization: Bearer <GAuth token>'''. See details about {{Link-AnywhereElse|product=PEC-Developer|version=Current|manual=WebAPIs|topic=Authentication|display text=GAuth token}}.
 +
| header
 +
| string
 +
| Yes
 
|}
 
|}
 
<div class="web-api-section-heading">Responses</div>
 
<div class="web-api-section-heading">Responses</div>
Line 529: Line 584:
 
-H "x-api-key: your_API_key"
 
-H "x-api-key: your_API_key"
 
-H "Content-Type: application/json"
 
-H "Content-Type: application/json"
−
 
+
-H "Authorization: Bearer eyJhbGciOiJSU...afA1Q"
 
"https://api-demo.com/udm/v10/export/history?descAsc=string&jobId=string&type=string&orderField=string&fileName=string&status=string&from=string&title=string&size=string&source=string&bgUpdate=string"
 
"https://api-demo.com/udm/v10/export/history?descAsc=string&jobId=string&type=string&orderField=string&fileName=string&status=string&from=string&title=string&size=string&source=string&bgUpdate=string"
 
</source>
 
</source>
Line 549: Line 604:
 
| x-api-key
 
| x-api-key
 
|  
 
|  
−
|  
+
| API key provided by Genesys. UDM deployments are accessed through GAPI-based URLs, for example, <nowiki>https://gapi-use1.genesyscloud.com/udm</nowiki>
 
| header
 
| header
 
| string
 
| string
Line 560: Line 615:
 
| string
 
| string
 
| true
 
| true
 +
|-
 +
| Authorization
 +
|
 +
| Bearer token in the format, '''Authorization: Bearer <GAuth token>'''. See details about {{Link-AnywhereElse|product=PEC-Developer|version=Current|manual=WebAPIs|topic=Authentication|display text=GAuth token}}.
 +
| header
 +
| string
 +
| Yes
 
|}
 
|}
 
<div class="web-api-section-heading">Responses</div>
 
<div class="web-api-section-heading">Responses</div>
Line 576: Line 638:
 
-H "x-api-key: your_API_key"
 
-H "x-api-key: your_API_key"
 
-H "Content-Type: application/json"
 
-H "Content-Type: application/json"
−
 
+
-H "Authorization: Bearer eyJhbGciOiJSU...afA1Q"
 
"https://api-demo.com/udm/v10/export/history?jobIDs=string"
 
"https://api-demo.com/udm/v10/export/history?jobIDs=string"
 
</source>
 
</source>
Line 596: Line 658:
 
| x-api-key
 
| x-api-key
 
|  
 
|  
−
|  
+
| API key provided by Genesys. UDM deployments are accessed through GAPI-based URLs, for example, <nowiki>https://gapi-use1.genesyscloud.com/udm</nowiki>
 
| header
 
| header
 
| string
 
| string
Line 607: Line 669:
 
| string
 
| string
 
| true
 
| true
 +
|-
 +
| Authorization
 +
|
 +
| Bearer token in the format, '''Authorization: Bearer <GAuth token>'''. See details about {{Link-AnywhereElse|product=PEC-Developer|version=Current|manual=WebAPIs|topic=Authentication|display text=GAuth token}}.
 +
| header
 +
| string
 +
| Yes
 
|}
 
|}
 
<div class="web-api-section-heading">Responses</div>
 
<div class="web-api-section-heading">Responses</div>
Line 704: Line 773:
 
-H "x-api-key: your_API_key"
 
-H "x-api-key: your_API_key"
 
-H "Content-Type: application/json"
 
-H "Content-Type: application/json"
−
 
+
-H "Authorization: Bearer eyJhbGciOiJSU...afA1Q"
 
"https://api-demo.com/udm/v10/export/history/{id}?"
 
"https://api-demo.com/udm/v10/export/history/{id}?"
 
</source>
 
</source>
Line 724: Line 793:
 
| x-api-key
 
| x-api-key
 
|  
 
|  
−
|  
+
| API key provided by Genesys. UDM deployments are accessed through GAPI-based URLs, for example, <nowiki>https://gapi-use1.genesyscloud.com/udm</nowiki>
 
| header
 
| header
 
| string
 
| string
Line 735: Line 804:
 
| string
 
| string
 
| true
 
| true
−
|}
+
|-
 +
| Authorization
 +
|
 +
| Bearer token in the format, '''Authorization: Bearer <GAuth token>'''. See details about {{Link-AnywhereElse|product=PEC-Developer|version=Current|manual=WebAPIs|topic=Authentication|display text=GAuth token}}.
 +
| header
 +
| string
 +
| Yes
 +
|}
 
<div class="web-api-section-heading">Responses</div>
 
<div class="web-api-section-heading">Responses</div>
 
{| class="web-api-responses-table"
 
{| class="web-api-responses-table"
Line 751: Line 827:
 
-H "x-api-key: your_API_key"
 
-H "x-api-key: your_API_key"
 
-H "Content-Type: application/json"
 
-H "Content-Type: application/json"
−
 
+
-H "Authorization: Bearer eyJhbGciOiJSU...afA1Q"
 
"https://api-demo.com/udm/v10/export/history/{id}?"
 
"https://api-demo.com/udm/v10/export/history/{id}?"
 
</source>
 
</source>
Line 771: Line 847:
 
| x-api-key
 
| x-api-key
 
|  
 
|  
−
|  
+
| API key provided by Genesys. UDM deployments are accessed through GAPI-based URLs, for example, <nowiki>https://gapi-use1.genesyscloud.com/udm</nowiki>
 
| header
 
| header
 
| string
 
| string
Line 782: Line 858:
 
| string
 
| string
 
| true
 
| true
 +
|-
 +
| Authorization
 +
|
 +
| Bearer token in the format, '''Authorization: Bearer <GAuth token>'''. See details about {{Link-AnywhereElse|product=PEC-Developer|version=Current|manual=WebAPIs|topic=Authentication|display text=GAuth token}}.
 +
| header
 +
| string
 +
| Yes
 
|}
 
|}
 
<div class="web-api-section-heading">Responses</div>
 
<div class="web-api-section-heading">Responses</div>
Line 819: Line 902:
 
-H "x-api-key: your_API_key"
 
-H "x-api-key: your_API_key"
 
-H "Content-Type: application/json"
 
-H "Content-Type: application/json"
−
 
+
-H "Authorization: Bearer eyJhbGciOiJSU...afA1Q"
 
"https://api-demo.com/udm/v10/export/history/{id}/progress?"
 
"https://api-demo.com/udm/v10/export/history/{id}/progress?"
 
</source>
 
</source>
Line 853: Line 936:
 
| x-api-key
 
| x-api-key
 
|  
 
|  
−
|  
+
| API key provided by Genesys. UDM deployments are accessed through GAPI-based URLs, for example, <nowiki>https://gapi-use1.genesyscloud.com/udm</nowiki>
 
| header
 
| header
 
| string
 
| string
Line 913: Line 996:
 
| string
 
| string
 
|  
 
|  
 +
|-
 +
| Authorization
 +
|
 +
| Bearer token in the format, '''Authorization: Bearer <GAuth token>'''. See details about {{Link-AnywhereElse|product=PEC-Developer|version=Current|manual=WebAPIs|topic=Authentication|display text=GAuth token}}.
 +
| header
 +
| string
 +
| Yes
 
|}
 
|}
 
<div class="web-api-section-heading">Responses</div>
 
<div class="web-api-section-heading">Responses</div>
Line 961: Line 1,051:
 
-H "x-api-key: your_API_key"
 
-H "x-api-key: your_API_key"
 
-H "Content-Type: application/json"
 
-H "Content-Type: application/json"
−
 
+
-H "Authorization: Bearer eyJhbGciOiJSU...afA1Q"
 
"https://api-demo.com/udm/v10/export/jobs?descAsc=string&scheduleType=string&type=string&orderField=string&suspend=string&from=string&title=string&size=string&source=string&bgUpdate=string"
 
"https://api-demo.com/udm/v10/export/jobs?descAsc=string&scheduleType=string&type=string&orderField=string&suspend=string&from=string&title=string&size=string&source=string&bgUpdate=string"
 
</source>
 
</source>
Line 981: Line 1,071:
 
| x-api-key
 
| x-api-key
 
|  
 
|  
 +
| API key provided by Genesys. UDM deployments are accessed through GAPI-based URLs, for example, <nowiki>https://gapi-use1.genesyscloud.com/udm</nowiki>
 +
| header
 +
| string
 +
|
 +
|-
 +
| Authorization
 
|  
 
|  
 +
| Bearer token in the format, '''Authorization: Bearer <GAuth token>'''. See details about {{Link-AnywhereElse|product=PEC-Developer|version=Current|manual=WebAPIs|topic=Authentication|display text=GAuth token}}.
 
| header
 
| header
 
| string
 
| string
−
|  
+
| Yes
 
|-
 
|-
 
| Job
 
| Job
Line 1,187: Line 1,284:
 
-H "x-api-key: your_API_key"
 
-H "x-api-key: your_API_key"
 
-H "Content-Type: application/json"
 
-H "Content-Type: application/json"
 +
-H "Authorization: Bearer eyJhbGciOiJSU...afA1Q"
 
-d '{
 
-d '{
 
   "source": "string",
 
   "source": "string",
Line 1,232: Line 1,330:
 
| x-api-key
 
| x-api-key
 
|  
 
|  
−
|  
+
| API key provided by Genesys. UDM deployments are accessed through GAPI-based URLs, for example, <nowiki>https://gapi-use1.genesyscloud.com/udm</nowiki>
 
| header
 
| header
 
| string
 
| string
Line 1,243: Line 1,341:
 
| string
 
| string
 
| true
 
| true
 +
|-
 +
| Authorization
 +
|
 +
| Bearer token in the format, '''Authorization: Bearer <GAuth token>'''. See details about {{Link-AnywhereElse|product=PEC-Developer|version=Current|manual=WebAPIs|topic=Authentication|display text=GAuth token}}.
 +
| header
 +
| string
 +
| Yes
 
|}
 
|}
 
<div class="web-api-section-heading">Responses</div>
 
<div class="web-api-section-heading">Responses</div>
Line 1,259: Line 1,364:
 
-H "x-api-key: your_API_key"
 
-H "x-api-key: your_API_key"
 
-H "Content-Type: application/json"
 
-H "Content-Type: application/json"
−
 
+
-H "Authorization: Bearer eyJhbGciOiJSU...afA1Q"
 
"https://api-demo.com/udm/v10/export/jobs?jobIDs=string"
 
"https://api-demo.com/udm/v10/export/jobs?jobIDs=string"
 
</source>
 
</source>
Line 1,279: Line 1,384:
 
| x-api-key
 
| x-api-key
 
|  
 
|  
−
|  
+
| API key provided by Genesys. UDM deployments are accessed through GAPI-based URLs, for example, <nowiki>https://gapi-use1.genesyscloud.com/udm</nowiki>
 
| header
 
| header
 
| string
 
| string
Line 1,290: Line 1,395:
 
| string
 
| string
 
| true
 
| true
 +
|-
 +
| Authorization
 +
|
 +
| Bearer token in the format, '''Authorization: Bearer <GAuth token>'''. See details about {{Link-AnywhereElse|product=PEC-Developer|version=Current|manual=WebAPIs|topic=Authentication|display text=GAuth token}}.
 +
| header
 +
| string
 +
| Yes
 
|}
 
|}
 
<div class="web-api-section-heading">Responses</div>
 
<div class="web-api-section-heading">Responses</div>
Line 1,309: Line 1,421:
 
-H "x-api-key: your_API_key"
 
-H "x-api-key: your_API_key"
 
-H "Content-Type: application/json"
 
-H "Content-Type: application/json"
−
 
+
-H "Authorization: Bearer eyJhbGciOiJSU...afA1Q"
 
"https://api-demo.com/udm/v10/export/jobs/cancel/{id}?"
 
"https://api-demo.com/udm/v10/export/jobs/cancel/{id}?"
 
</source>
 
</source>
Line 1,329: Line 1,441:
 
| x-api-key
 
| x-api-key
 
|  
 
|  
−
|  
+
| API key provided by Genesys. UDM deployments are accessed through GAPI-based URLs, for example, <nowiki>https://gapi-use1.genesyscloud.com/udm</nowiki>
 
| header
 
| header
 
| string
 
| string
Line 1,340: Line 1,452:
 
| string
 
| string
 
| true
 
| true
 +
|-
 +
| Authorization
 +
|
 +
| Bearer token in the format, '''Authorization: Bearer <GAuth token>'''. See details about {{Link-AnywhereElse|product=PEC-Developer|version=Current|manual=WebAPIs|topic=Authentication|display text=GAuth token}}.
 +
| header
 +
| string
 +
| Yes
 
|}
 
|}
 
<div class="web-api-section-heading">Responses</div>
 
<div class="web-api-section-heading">Responses</div>
Line 1,421: Line 1,540:
 
-H "x-api-key: your_API_key"
 
-H "x-api-key: your_API_key"
 
-H "Content-Type: application/json"
 
-H "Content-Type: application/json"
−
 
+
-H "Authorization: Bearer eyJhbGciOiJSU...afA1Q"
 
"https://api-demo.com/udm/v10/export/jobs/resume/{id}?"
 
"https://api-demo.com/udm/v10/export/jobs/resume/{id}?"
 
</source>
 
</source>
Line 1,441: Line 1,560:
 
| x-api-key
 
| x-api-key
 
|  
 
|  
−
|  
+
| API key provided by Genesys. UDM deployments are accessed through GAPI-based URLs, for example, <nowiki>https://gapi-use1.genesyscloud.com/udm</nowiki>
 
| header
 
| header
 
| string
 
| string
Line 1,452: Line 1,571:
 
| string
 
| string
 
| true
 
| true
 +
|-
 +
| Authorization
 +
|
 +
| Bearer token in the format, '''Authorization: Bearer <GAuth token>'''. See details about {{Link-AnywhereElse|product=PEC-Developer|version=Current|manual=WebAPIs|topic=Authentication|display text=GAuth token}}.
 +
| header
 +
| string
 +
| Yes
 
|}
 
|}
 
<div class="web-api-section-heading">Responses</div>
 
<div class="web-api-section-heading">Responses</div>
Line 1,533: Line 1,659:
 
-H "x-api-key: your_API_key"
 
-H "x-api-key: your_API_key"
 
-H "Content-Type: application/json"
 
-H "Content-Type: application/json"
−
 
+
-H "Authorization: Bearer eyJhbGciOiJSU...afA1Q"
 
"https://api-demo.com/udm/v10/export/jobs/suspend/{id}?"
 
"https://api-demo.com/udm/v10/export/jobs/suspend/{id}?"
 
</source>
 
</source>
Line 1,553: Line 1,679:
 
| x-api-key
 
| x-api-key
 
|  
 
|  
−
|  
+
| API key provided by Genesys. UDM deployments are accessed through GAPI-based URLs, for example, <nowiki>https://gapi-use1.genesyscloud.com/udm</nowiki>
 
| header
 
| header
 
| string
 
| string
Line 1,564: Line 1,690:
 
| string
 
| string
 
| true
 
| true
 +
|-
 +
| Authorization
 +
|
 +
| Bearer token in the format, '''Authorization: Bearer <GAuth token>'''. See details about {{Link-AnywhereElse|product=PEC-Developer|version=Current|manual=WebAPIs|topic=Authentication|display text=GAuth token}}.
 +
| header
 +
| string
 +
| Yes
 
|}
 
|}
 
<div class="web-api-section-heading">Responses</div>
 
<div class="web-api-section-heading">Responses</div>
Line 1,645: Line 1,778:
 
-H "x-api-key: your_API_key"
 
-H "x-api-key: your_API_key"
 
-H "Content-Type: application/json"
 
-H "Content-Type: application/json"
−
 
+
-H "Authorization: Bearer eyJhbGciOiJSU...afA1Q"
 
"https://api-demo.com/udm/v10/export/jobs/{id}?"
 
"https://api-demo.com/udm/v10/export/jobs/{id}?"
 
</source>
 
</source>
Line 1,665: Line 1,798:
 
| x-api-key
 
| x-api-key
 
|  
 
|  
−
|  
+
| API key provided by Genesys. UDM deployments are accessed through GAPI-based URLs, for example, <nowiki>https://gapi-use1.genesyscloud.com/udm</nowiki>
 
| header
 
| header
 
| string
 
| string
Line 1,676: Line 1,809:
 
| string
 
| string
 
| true
 
| true
 +
|-
 +
| Authorization
 +
|
 +
| Bearer token in the format, '''Authorization: Bearer <GAuth token>'''. See details about {{Link-AnywhereElse|product=PEC-Developer|version=Current|manual=WebAPIs|topic=Authentication|display text=GAuth token}}.
 +
| header
 +
| string
 +
| Yes
 
|-
 
|-
 
| Job
 
| Job
Line 1,846: Line 1,986:
 
-H "x-api-key: your_API_key"
 
-H "x-api-key: your_API_key"
 
-H "Content-Type: application/json"
 
-H "Content-Type: application/json"
 +
-H "Authorization: Bearer eyJhbGciOiJSU...afA1Q"
 
-d '{
 
-d '{
 
   "source": "string",
 
   "source": "string",
Line 1,891: Line 2,032:
 
| x-api-key
 
| x-api-key
 
|  
 
|  
−
|  
+
| API key provided by Genesys. UDM deployments are accessed through GAPI-based URLs, for example, <nowiki>https://gapi-use1.genesyscloud.com/udm</nowiki>
 
| header
 
| header
 
| string
 
| string
Line 1,902: Line 2,043:
 
| string
 
| string
 
| true
 
| true
 +
|-
 +
| Authorization
 +
|
 +
| Bearer token in the format, '''Authorization: Bearer <GAuth token>'''. See details about {{Link-AnywhereElse|product=PEC-Developer|version=Current|manual=WebAPIs|topic=Authentication|display text=GAuth token}}.
 +
| header
 +
| string
 +
| Yes
 
|}
 
|}
 
<div class="web-api-section-heading">Responses</div>
 
<div class="web-api-section-heading">Responses</div>
Line 1,918: Line 2,066:
 
-H "x-api-key: your_API_key"
 
-H "x-api-key: your_API_key"
 
-H "Content-Type: application/json"
 
-H "Content-Type: application/json"
−
 
+
-H "Authorization: Bearer eyJhbGciOiJSU...afA1Q"
 
"https://api-demo.com/udm/v10/export/jobs/{id}?"
 
"https://api-demo.com/udm/v10/export/jobs/{id}?"
 
</source>
 
</source>
Line 2,026: Line 2,174:
 
| string
 
| string
 
|  
 
|  
 +
|-
 +
| Authorization
 +
|
 +
| Bearer token in the format, '''Authorization: Bearer <GAuth token>'''. See details about {{Link-AnywhereElse|product=PEC-Developer|version=Current|manual=WebAPIs|topic=Authentication|display text=GAuth token}}.
 +
| header
 +
| string
 +
| Yes
 
|}
 
|}
 
<div class="web-api-section-heading">Responses</div>
 
<div class="web-api-section-heading">Responses</div>
Line 2,071: Line 2,226:
 
-H "x-api-key: your_API_key"
 
-H "x-api-key: your_API_key"
 
-H "Content-Type: application/json"
 
-H "Content-Type: application/json"
−
 
+
-H "Authorization: Bearer eyJhbGciOiJSU...afA1Q"
 
"https://api-demo.com/udm/v10/file-metadatas?historyId=string&descAsc=string&jobTitle=string&name=string&type=string&source=string&endDate=string&orderField=string&startDate=string&from=string&size=string&bgUpdate=string"
 
"https://api-demo.com/udm/v10/file-metadatas?historyId=string&descAsc=string&jobTitle=string&name=string&type=string&source=string&endDate=string&orderField=string&startDate=string&from=string&size=string&bgUpdate=string"
 
</source>
 
</source>
Line 2,098: Line 2,253:
 
| x-api-key
 
| x-api-key
 
|  
 
|  
 +
| API key provided by Genesys. UDM deployments are accessed through GAPI-based URLs, for example, <nowiki>https://gapi-use1.genesyscloud.com/udm</nowiki>
 +
| header
 +
| string
 +
|
 +
|-
 +
| Authorization
 
|  
 
|  
 +
| Bearer token in the format, '''Authorization: Bearer <GAuth token>'''. See details about {{Link-AnywhereElse|product=PEC-Developer|version=Current|manual=WebAPIs|topic=Authentication|display text=GAuth token}}.
 
| header
 
| header
 
| string
 
| string
−
|  
+
| Yes
 
|}
 
|}
 
<div class="web-api-section-heading">Responses</div>
 
<div class="web-api-section-heading">Responses</div>
Line 2,143: Line 2,305:
 
-H "x-api-key: your_API_key"
 
-H "x-api-key: your_API_key"
 
-H "Content-Type: application/json"
 
-H "Content-Type: application/json"
−
 
+
-H "Authorization: Bearer eyJhbGciOiJSU...afA1Q"
 
"https://api-demo.com/udm/v10/files?filename=string"
 
"https://api-demo.com/udm/v10/files?filename=string"
 
</source>
 
</source>
Line 2,170: Line 2,332:
 
| x-api-key
 
| x-api-key
 
|  
 
|  
 +
| API key provided by Genesys. UDM deployments are accessed through GAPI-based URLs, for example, <nowiki>https://gapi-use1.genesyscloud.com/udm</nowiki>
 +
| header
 +
| string
 +
|
 +
|-
 +
| Authorization
 
|  
 
|  
 +
| Bearer token in the format, '''Authorization: Bearer <GAuth token>'''. See details about {{Link-AnywhereElse|product=PEC-Developer|version=Current|manual=WebAPIs|topic=Authentication|display text=GAuth token}}.
 
| header
 
| header
 
| string
 
| string
−
|  
+
| Yes
 
|}
 
|}
 
<div class="web-api-section-heading">Responses</div>
 
<div class="web-api-section-heading">Responses</div>
Line 2,187: Line 2,356:
 
-H "x-api-key: your_API_key"
 
-H "x-api-key: your_API_key"
 
-H "Content-Type: application/json"
 
-H "Content-Type: application/json"
−
 
+
-H "Authorization: Bearer eyJhbGciOiJSU...afA1Q"
 
"https://api-demo.com/udm/v10/files?filename=string"
 
"https://api-demo.com/udm/v10/files?filename=string"
 
</source>
 
</source>
Line 2,214: Line 2,383:
 
| x-api-key
 
| x-api-key
 
|  
 
|  
 +
| API key provided by Genesys. UDM deployments are accessed through GAPI-based URLs, for example, <nowiki>https://gapi-use1.genesyscloud.com/udm</nowiki>
 +
| header
 +
| string
 +
|
 +
|-
 +
| Authorization
 
|  
 
|  
 +
| Bearer token in the format, '''Authorization: Bearer <GAuth token>'''. See details about {{Link-AnywhereElse|product=PEC-Developer|version=Current|manual=WebAPIs|topic=Authentication|display text=GAuth token}}.
 
| header
 
| header
 
| string
 
| string
−
|  
+
| Yes
 
|}
 
|}
 
<div class="web-api-section-heading">Responses</div>
 
<div class="web-api-section-heading">Responses</div>
Line 2,234: Line 2,410:
 
-H "x-api-key: your_API_key"
 
-H "x-api-key: your_API_key"
 
-H "Content-Type: application/json"
 
-H "Content-Type: application/json"
−
 
+
-H "Authorization: Bearer eyJhbGciOiJSU...afA1Q"
 
"https://api-demo.com/udm/v10/files/{filename}?"
 
"https://api-demo.com/udm/v10/files/{filename}?"
 
</source>
 
</source>
Line 2,261: Line 2,437:
 
| x-api-key
 
| x-api-key
 
|  
 
|  
 +
| API key provided by Genesys. UDM deployments are accessed through GAPI-based URLs, for example, <nowiki>https://gapi-use1.genesyscloud.com/udm</nowiki>
 +
| header
 +
| string
 
|  
 
|  
 +
|-
 +
| Authorization
 +
|
 +
| Bearer token in the format, '''Authorization: Bearer <GAuth token>'''. See details about {{Link-AnywhereElse|product=PEC-Developer|version=Current|manual=WebAPIs|topic=Authentication|display text=GAuth token}}.
 
| header
 
| header
 
| string
 
| string
−
|  
+
| Yes
 
|}
 
|}
 
<div class="web-api-section-heading">Responses</div>
 
<div class="web-api-section-heading">Responses</div>
Line 2,278: Line 2,461:
 
-H "x-api-key: your_API_key"
 
-H "x-api-key: your_API_key"
 
-H "Content-Type: application/json"
 
-H "Content-Type: application/json"
−
 
+
-H "Authorization: Bearer eyJhbGciOiJSU...afA1Q"
 
"https://api-demo.com/udm/v10/files/{filename}?"
 
"https://api-demo.com/udm/v10/files/{filename}?"
 
</source>
 
</source>
Line 2,304: Line 2,487:
 
-H "x-api-key: your_API_key"
 
-H "x-api-key: your_API_key"
 
-H "Content-Type: application/json"
 
-H "Content-Type: application/json"
−
 
+
-H "Authorization: Bearer eyJhbGciOiJSU...afA1Q"
 
"https://api-demo.com/udm/v10/resources/labels?"
 
"https://api-demo.com/udm/v10/resources/labels?"
 
</source>
 
</source>
Line 2,324: Line 2,507:
 
| x-api-key
 
| x-api-key
 
|  
 
|  
−
|  
+
| API key provided by Genesys. UDM deployments are accessed through GAPI-based URLs, for example, <nowiki>https://gapi-use1.genesyscloud.com/udm</nowiki>
 
| header
 
| header
 
| string
 
| string
Line 2,365: Line 2,548:
 
-H "x-api-key: your_API_key"
 
-H "x-api-key: your_API_key"
 
-H "Content-Type: application/json"
 
-H "Content-Type: application/json"
−
 
 
"https://api-demo.com/udm/v10/version?"
 
"https://api-demo.com/udm/v10/version?"
 
</source>
 
</source>
 
</div>
 
</div>
 
</div>
 
</div>
 +
  
 
=== Version 4 API Requests ===
 
=== Version 4 API Requests ===

Latest revision as of 05:30, May 14, 2024

This topic is part of the manual Genesys Multicloud CX Web-based API Reference for version Current of Developer.



Base path: /udm

Version 10 API Requests

GET
/v10/cipher
This request is intended to get already uploaded certificate info.
Parameters
Name Default Description Parameter Type Data Type Required
x-api-key API key provided by Genesys. UDM deployments are accessed through GAPI-based URLs, for example, https://gapi-use1.genesyscloud.com/udm header string
Authorization Bearer token in the format, Authorization: Bearer <GAuth token>. See details about GAuth token. header string Yes
Responses
Code Reason
200 200 response 
{
  "ccid": "string",
  "name": "string",
  "size": 0,
  "lastModified": "string"
}
CertificateInfo
ccid (string):
name (string):
size (integer):
lastModified (string):
Usage
curl -X GET
-H "x-api-key: your_API_key"
-H "Content-Type: application/json"
-H "Authorization: Bearer eyJhbGciOiJSU...afA1Q"
"https://api-demo.com/udm/v10/cipher?"
POST
/v10/cipher/{certificatefilename}
This request is intended to upload a certificate.
Parameters
Name Default Description Parameter Type Data Type Required
x-api-key API key provided by Genesys. UDM deployments are accessed through GAPI-based URLs, for example, https://gapi-use1.genesyscloud.com/udm header string
certificatefilename path string true
file The certificate content, <input> field name must be 'file' formData file true
Authorization Bearer token in the format, Authorization: Bearer <GAuth token>. See details about GAuth token. header string Yes
Responses
Code Reason
201 201 response 
"string"
400 400 response
Usage
curl -X POST
-H "x-api-key: your_API_key"
-H "Content-Type: application/json"
-H "Authorization: Bearer eyJhbGciOiJSU...afA1Q"
"https://api-demo.com/udm/v10/cipher/{certificatefilename}?"
GET
/v10/data/attributes
This request is intended to get allow filtering on top of interaction attributes.
Parameters
Name Default Description Parameter Type Data Type Required
entities query string
Authorization Bearer token in the format, Authorization: Bearer <GAuth token>. See details about GAuth token. header string Yes
Responses
Code Reason
200 200 response 
{}
Usage
curl -X GET
-H "x-api-key: your_API_key"
-H "Content-Type: application/json"
-H "Authorization: Bearer eyJhbGciOiJSU...afA1Q"
"https://api-demo.com/udm/v10/data/attributes?entities=string"
GET
/v10/data/job-statuses
This request is intended to get a list of job statuses.
Parameters
Name Default Description Parameter Type Data Type Required
x-api-key API key provided by Genesys. UDM deployments are accessed through GAPI-based URLs, for example, https://gapi-use1.genesyscloud.com/udm header string
Authorization Bearer token in the format, Authorization: Bearer <GAuth token>. See details about GAuth token. header string Yes
Responses
Code Reason
200 200 response 
{}
Usage
curl -X GET
-H "x-api-key: your_API_key"
-H "Content-Type: application/json"
-H "Authorization: Bearer eyJhbGciOiJSU...afA1Q"
"https://api-demo.com/udm/v10/data/job-statuses?"
GET
/v10/data/sources
This request is intended to get a list of sources.
Parameters
Name Default Description Parameter Type Data Type Required
x-api-key API key provided by Genesys. UDM deployments are accessed through GAPI-based URLs, for example, https://gapi-use1.genesyscloud.com/udm header string
Authorization Bearer token in the format, Authorization: Bearer <GAuth token>. See details about GAuth token. header string Yes
Responses
Code Reason
200 200 response 
{}
204 204 response
Usage
curl -X GET
-H "x-api-key: your_API_key"
-H "Content-Type: application/json"
-H "Authorization: Bearer eyJhbGciOiJSU...afA1Q"
"https://api-demo.com/udm/v10/data/sources?"
GET
/v10/data/sub-types
This request is intended to get a list of entities for specific type and source.
Parameters
Name Default Description Parameter Type Data Type Required
x-api-key API key provided by Genesys. UDM deployments are accessed through GAPI-based URLs, for example, https://gapi-use1.genesyscloud.com/udm header string
dataType query string
source query string
Authorization Bearer token in the format, Authorization: Bearer <GAuth token>. See details about GAuth token. header string Yes
Responses
Code Reason
200 200 response 
{}
204 204 response
400 400 response
Usage
curl -X GET
-H "x-api-key: your_API_key"
-H "Content-Type: application/json"
-H "Authorization: Bearer eyJhbGciOiJSU...afA1Q"
"https://api-demo.com/udm/v10/data/sub-types?dataType=string&source=string"
GET
/v10/data/types
This request is intended to get a list of types for specific source.
Parameters
Name Default Description Parameter Type Data Type Required
x-api-key API key provided by Genesys. UDM deployments are accessed through GAPI-based URLs, for example, https://gapi-use1.genesyscloud.com/udm header string
source query string
Authorization Bearer token in the format, Authorization: Bearer <GAuth token>. See details about GAuth token. header string Yes
Responses
Code Reason
200 200 response 
{}
204 204 response
Usage
curl -X GET
-H "x-api-key: your_API_key"
-H "Content-Type: application/json"
-H "Authorization: Bearer eyJhbGciOiJSU...afA1Q"
"https://api-demo.com/udm/v10/data/types?source=string"
GET
/v10/export/history
This request is intended to get a list of history records.
Parameters
Name Default Description Parameter Type Data Type Required
x-api-key API key provided by Genesys. UDM deployments are accessed through GAPI-based URLs, for example, https://gapi-use1.genesyscloud.com/udm header string
descAsc query string
jobId query string
type query string
orderField query string
fileName query string
status query string
from query string
title query string
size query string
source query string
bgUpdate query string
Authorization Bearer token in the format, Authorization: Bearer <GAuth token>. See details about GAuth token. header string Yes
Responses
Code Reason
200 200 response 
{
  "count": 0,
  "from": 0,
  "items": [

  ],
  "size": 0
}
items
PagedResponse
count (integer):
from (integer):
items (array:object):
size (integer):
204 204 response
Usage
curl -X GET
-H "x-api-key: your_API_key"
-H "Content-Type: application/json"
-H "Authorization: Bearer eyJhbGciOiJSU...afA1Q"
"https://api-demo.com/udm/v10/export/history?descAsc=string&jobId=string&type=string&orderField=string&fileName=string&status=string&from=string&title=string&size=string&source=string&bgUpdate=string"
DELETE
/v10/export/history
This request is intended to delete a bunch of history records.
Parameters
Name Default Description Parameter Type Data Type Required
x-api-key API key provided by Genesys. UDM deployments are accessed through GAPI-based URLs, for example, https://gapi-use1.genesyscloud.com/udm header string
jobIDs query string true
Authorization Bearer token in the format, Authorization: Bearer <GAuth token>. See details about GAuth token. header string Yes
Responses
Code Reason
204 204 response
400 400 response
Usage
curl -X DELETE
-H "x-api-key: your_API_key"
-H "Content-Type: application/json"
-H "Authorization: Bearer eyJhbGciOiJSU...afA1Q"
"https://api-demo.com/udm/v10/export/history?jobIDs=string"
GET
/v10/export/history/{id}
This request is intended to get history record info.
Parameters
Name Default Description Parameter Type Data Type Required
x-api-key API key provided by Genesys. UDM deployments are accessed through GAPI-based URLs, for example, https://gapi-use1.genesyscloud.com/udm header string
id path string true
Authorization Bearer token in the format, Authorization: Bearer <GAuth token>. See details about GAuth token. header string Yes
Responses
Code Reason
200 200 response 
{
  "id": 0,
  "type": "string",
  "source": "string",
  "title": "string",
  "fileSplitSize": "string",
  "fileName": "string",
  "fileSize": 0,
  "status": "string",
  "createdDate": "string",
  "dateFrom": "string",
  "dateTo": "string",
  "description": "string",
  "media": [

  ],
  "progress": 0,
  "parentId": 0,
  "exportAttachments": true
}
JobInfo
id (integer):
type (string):
source (string):
title (string):
fileSplitSize (string):
fileName (string):
fileSize (integer):
status (string):
createdDate (string):
dateFrom (string):
dateTo (string):
description (string):
media (array:string):
progress (integer):
parentId (integer):
exportAttachments (boolean):
400 400 response
404 404 response
Usage
curl -X GET
-H "x-api-key: your_API_key"
-H "Content-Type: application/json"
-H "Authorization: Bearer eyJhbGciOiJSU...afA1Q"
"https://api-demo.com/udm/v10/export/history/{id}?"
DELETE
/v10/export/history/{id}
This request is intended to delete a history record.
Parameters
Name Default Description Parameter Type Data Type Required
x-api-key API key provided by Genesys. UDM deployments are accessed through GAPI-based URLs, for example, https://gapi-use1.genesyscloud.com/udm header string
id path string true
Authorization Bearer token in the format, Authorization: Bearer <GAuth token>. See details about GAuth token. header string Yes
Responses
Code Reason
204 204 response
400 400 response
Usage
curl -X DELETE
-H "x-api-key: your_API_key"
-H "Content-Type: application/json"
-H "Authorization: Bearer eyJhbGciOiJSU...afA1Q"
"https://api-demo.com/udm/v10/export/history/{id}?"
GET
/v10/export/history/{id}/progress
This request is intended to get job progress.
Parameters
Name Default Description Parameter Type Data Type Required
x-api-key API key provided by Genesys. UDM deployments are accessed through GAPI-based URLs, for example, https://gapi-use1.genesyscloud.com/udm header string
id path string true
Authorization Bearer token in the format, Authorization: Bearer <GAuth token>. See details about GAuth token. header string Yes
Responses
Code Reason
200 200 response 
{
  "progress": 0,
  "status": "string"
}
JobProgress
progress (integer):
status (string):
400 400 response
Usage
curl -X GET
-H "x-api-key: your_API_key"
-H "Content-Type: application/json"
-H "Authorization: Bearer eyJhbGciOiJSU...afA1Q"
"https://api-demo.com/udm/v10/export/history/{id}/progress?"
GET
/v10/export/jobs
This request is intended to get a list of jobs.
Parameters
Name Default Description Parameter Type Data Type Required
descAsc query string
scheduleType query string
x-api-key API key provided by Genesys. UDM deployments are accessed through GAPI-based URLs, for example, https://gapi-use1.genesyscloud.com/udm header string
type query string
orderField query string
suspend query string
from query string
title query string
size query string
source query string
bgUpdate query string
Authorization Bearer token in the format, Authorization: Bearer <GAuth token>. See details about GAuth token. header string Yes
Responses
Code Reason
200 200 response 
{
  "count": 0,
  "from": 0,
  "items": [

  ],
  "size": 0
}
items
PagedResponse
count (integer):
from (integer):
items (array:object):
size (integer):
204 204 response
Usage
curl -X GET
-H "x-api-key: your_API_key"
-H "Content-Type: application/json"
-H "Authorization: Bearer eyJhbGciOiJSU...afA1Q"
"https://api-demo.com/udm/v10/export/jobs?descAsc=string&scheduleType=string&type=string&orderField=string&suspend=string&from=string&title=string&size=string&source=string&bgUpdate=string"
POST
/v10/export/jobs
This request is intended to create a job.
Parameters
Name Default Description Parameter Type Data Type Required
x-api-key API key provided by Genesys. UDM deployments are accessed through GAPI-based URLs, for example, https://gapi-use1.genesyscloud.com/udm header string
Authorization Bearer token in the format, Authorization: Bearer <GAuth token>. See details about GAuth token. header string Yes
Job body true 
{
  "source": "string",
  "type": "string",
  "title": "string",
  "timeFrame": {
    "all": true,
    "dateFrom": "string",
    "dateTo": "string"
  },
  "description": "string",
  "schedulerParam": {
    "immediately": true,
    "cron": "string",
    "runs": "string",
    "startDate": "string"
  },
  "jobParams": {
    "fileSplitSize": "string",
    "type": "string",
    "media": [

    ],
    "exportAttachments": true
  },
  "suspended": true
}
TimeFrame
all (boolean, optional):
dateFrom (string, optional):
dateTo (string, optional):
SchedulerParam
immediately (boolean, optional):
cron (string, optional):
runs (string, optional):
startDate (string, optional):
UcsJobParams
fileSplitSize (string, optional):
type (string, required):
media (array:string, required):
exportAttachments (boolean, optional):
Job
source (string, required): source of job
type (string, required): UCS or DataSync
title (string, required): title of job
timeFrame (TimeFrame, required): export time parameter of job
description (string, optional): A description
schedulerParam (SchedulerParam, required): scheduler parameter of job
jobParams (UcsJobParams, required): parameters of job
suspended (boolean, required): suspended job
Responses
Code Reason
202 202 response 
{
  "id": 0,
  "type": "string",
  "source": "string",
  "title": "string",
  "fileSplitSize": "string",
  "fileName": "string",
  "fileSize": 0,
  "status": "string",
  "createdDate": "string",
  "dateFrom": "string",
  "dateTo": "string",
  "description": "string",
  "media": [

  ],
  "progress": 0,
  "parentId": 0,
  "exportAttachments": true
}
JobInfo
id (integer):
type (string):
source (string):
title (string):
fileSplitSize (string):
fileName (string):
fileSize (integer):
status (string):
createdDate (string):
dateFrom (string):
dateTo (string):
description (string):
media (array:string):
progress (integer):
parentId (integer):
exportAttachments (boolean):
400 400 response
Usage
curl -X POST
-H "x-api-key: your_API_key"
-H "Content-Type: application/json"
-H "Authorization: Bearer eyJhbGciOiJSU...afA1Q"
-d '{
  "source": "string",
  "type": "string",
  "title": "string",
  "timeFrame": {
    "all": true,
    "dateFrom": "string",
    "dateTo": "string"
  },
  "description": "string",
  "schedulerParam": {
    "immediately": true,
    "cron": "string",
    "runs": "string",
    "startDate": "string"
  },
  "jobParams": {
    "fileSplitSize": "string",
    "type": "string",
    "media": [

    ],
    "exportAttachments": true
  },
  "suspended": true
}'
"https://api-demo.com/udm/v10/export/jobs?"
DELETE
/v10/export/jobs
This request is intended to delete a bunch of jobs.
Parameters
Name Default Description Parameter Type Data Type Required
x-api-key API key provided by Genesys. UDM deployments are accessed through GAPI-based URLs, for example, https://gapi-use1.genesyscloud.com/udm header string
jobIDs query string true
Authorization Bearer token in the format, Authorization: Bearer <GAuth token>. See details about GAuth token. header string Yes
Responses
Code Reason
204 204 response
400 400 response
Usage
curl -X DELETE
-H "x-api-key: your_API_key"
-H "Content-Type: application/json"
-H "Authorization: Bearer eyJhbGciOiJSU...afA1Q"
"https://api-demo.com/udm/v10/export/jobs?jobIDs=string"
POST
/v10/export/jobs/cancel/{id}
This request is intended to cancel an unfinished job.
Parameters
Name Default Description Parameter Type Data Type Required
x-api-key API key provided by Genesys. UDM deployments are accessed through GAPI-based URLs, for example, https://gapi-use1.genesyscloud.com/udm header string
id path string true
Authorization Bearer token in the format, Authorization: Bearer <GAuth token>. See details about GAuth token. header string Yes
Responses
Code Reason
200 200 response
400 400 response
404 404 response
Usage
curl -X POST
-H "x-api-key: your_API_key"
-H "Content-Type: application/json"
-H "Authorization: Bearer eyJhbGciOiJSU...afA1Q"
"https://api-demo.com/udm/v10/export/jobs/cancel/{id}?"
POST
/v10/export/jobs/resume/{id}
This request is intended to resume an unfinished job.
Parameters
Name Default Description Parameter Type Data Type Required
x-api-key API key provided by Genesys. UDM deployments are accessed through GAPI-based URLs, for example, https://gapi-use1.genesyscloud.com/udm header string
id path string true
Authorization Bearer token in the format, Authorization: Bearer <GAuth token>. See details about GAuth token. header string Yes
Responses
Code Reason
200 200 response 
{
  "id": 0,
  "type": "string",
  "source": "string",
  "title": "string",
  "fileSplitSize": "string",
  "fileName": "string",
  "fileSize": 0,
  "status": "string",
  "createdDate": "string",
  "dateFrom": "string",
  "dateTo": "string",
  "description": "string",
  "media": [

  ],
  "progress": 0,
  "parentId": 0,
  "exportAttachments": true
}
JobInfo
id (integer):
type (string):
source (string):
source (string):
fileSplitSize (string):
fileName (string):
fileSize (integer):
status (string):
createdDate (string):
createdDate (string):
dateTo (string):
description (string):
media (array:string):
progress (integer):
parentId (integer):
exportAttachments (boolean):
400 400 response
404 404 response
Usage
curl -X POST
-H "x-api-key: your_API_key"
-H "Content-Type: application/json"
-H "Authorization: Bearer eyJhbGciOiJSU...afA1Q"
"https://api-demo.com/udm/v10/export/jobs/resume/{id}?"
POST
/v10/export/jobs/suspend/{id}
This request is intended to suspend an unfinished job.
Parameters
Name Default Description Parameter Type Data Type Required
x-api-key API key provided by Genesys. UDM deployments are accessed through GAPI-based URLs, for example, https://gapi-use1.genesyscloud.com/udm header string
id path string true
Authorization Bearer token in the format, Authorization: Bearer <GAuth token>. See details about GAuth token. header string Yes
Responses
Code Reason
200 200 response 
{
  "id": 0,
  "type": "string",
  "source": "string",
  "title": "string",
  "fileSplitSize": "string",
  "fileName": "string",
  "fileSize": 0,
  "status": "string",
  "createdDate": "string",
  "dateFrom": "string",
  "dateTo": "string",
  "description": "string",
  "media": [

  ],
  "progress": 0,
  "parentId": 0,
  "exportAttachments": true
}
JobInfo
id (integer):
type (string):
source (string):
source (string):
fileSplitSize (string):
fileName (string):
fileSize (integer):
status (string):
createdDate (string):
createdDate (string):
dateTo (string):
description (string):
media (array:string):
progress (integer):
parentId (integer):
exportAttachments (boolean):
400 400 response
404 404 response
Usage
curl -X POST
-H "x-api-key: your_API_key"
-H "Content-Type: application/json"
-H "Authorization: Bearer eyJhbGciOiJSU...afA1Q"
"https://api-demo.com/udm/v10/export/jobs/suspend/{id}?"
GET
/v10/export/jobs/{id}
This request is intended to get job info.
Parameters
Name Default Description Parameter Type Data Type Required
x-api-key API key provided by Genesys. UDM deployments are accessed through GAPI-based URLs, for example, https://gapi-use1.genesyscloud.com/udm header string
id path string true
Authorization Bearer token in the format, Authorization: Bearer <GAuth token>. See details about GAuth token. header string Yes
Responses
Code Reason
200 200 response 
{
  "id": 0,
  "type": "string",
  "source": "string",
  "title": "string",
  "fileSplitSize": "string",
  "fileName": "string",
  "fileSize": 0,
  "status": "string",
  "createdDate": "string",
  "dateFrom": "string",
  "dateTo": "string",
  "description": "string",
  "media": [

  ],
  "progress": 0,
  "parentId": 0,
  "exportAttachments": true
}
JobInfo
id (integer):
type (string):
source (string):
source (string):
fileSplitSize (string):
fileName (string):
fileSize (integer):
status (string):
createdDate (string):
createdDate (string):
dateTo (string):
description (string):
media (array:string):
progress (integer):
parentId (integer):
exportAttachments (boolean):
400 400 response
404 404 response
Usage
curl -X GET
-H "x-api-key: your_API_key"
-H "Content-Type: application/json"
-H "Authorization: Bearer eyJhbGciOiJSU...afA1Q"
"https://api-demo.com/udm/v10/export/jobs/{id}?"
PUT
/v10/export/jobs/{id}
This request is intended to update not started job.
Parameters
Name Default Description Parameter Type Data Type Required
x-api-key API key provided by Genesys. UDM deployments are accessed through GAPI-based URLs, for example, https://gapi-use1.genesyscloud.com/udm header string
id path string true
Authorization Bearer token in the format, Authorization: Bearer <GAuth token>. See details about GAuth token. header string Yes
Job body true 
{
  "source": "string",
  "type": "string",
  "title": "string",
  "timeFrame": {
    "all": true,
    "dateFrom": "string",
    "dateTo": "string"
  },
  "description": "string",
  "schedulerParam": {
    "immediately": true,
    "cron": "string",
    "runs": "string",
    "startDate": "string"
  },
  "jobParams": {
    "fileSplitSize": "string",
    "type": "string",
    "media": [

    ],
    "exportAttachments": true
  },
  "suspended": true
}
TimeFrame
all (boolean, optional):
dateFrom (string, optional):
dateTo (string, optional):
SchedulerParam
immediately (boolean, optional):
cron (string, optional):
runs (string, optional):
startDate (string, optional):
UcsJobParams
fileSplitSize (string, optional):
type (string, required):
media (array:string, required):
exportAttachments (boolean, optional):
Job
source (string, required): source of job
type (string, required): UCS or DataSync
title (string, required): title of job
timeFrame (TimeFrame, required): export time parameter of job
description (string, optional): A description
schedulerParam (SchedulerParam, required): scheduler parameter of job
jobParams (UcsJobParams, required): parameters of job
suspended (boolean, required): suspended job
Responses
Code Reason
200 200 response 
{
  "id": 0,
  "type": "string",
  "source": "string",
  "title": "string",
  "fileSplitSize": "string",
  "fileName": "string",
  "fileSize": 0,
  "status": "string",
  "createdDate": "string",
  "dateFrom": "string",
  "dateTo": "string",
  "description": "string",
  "media": [

  ],
  "progress": 0,
  "parentId": 0,
  "exportAttachments": true
}
JobInfo
id (integer):
type (string):
source (string):
title (string):
fileSplitSize (string):
fileName (string):
fileSize (integer):
status (string):
createdDate (string):
dateFrom (string):
dateTo (string):
description (string):
media (array:string):
progress (integer):
parentId (integer):
exportAttachments (boolean):
400 400 response
404 404 response
Usage
curl -X PUT
-H "x-api-key: your_API_key"
-H "Content-Type: application/json"
-H "Authorization: Bearer eyJhbGciOiJSU...afA1Q"
-d '{
  "source": "string",
  "type": "string",
  "title": "string",
  "timeFrame": {
    "all": true,
    "dateFrom": "string",
    "dateTo": "string"
  },
  "description": "string",
  "schedulerParam": {
    "immediately": true,
    "cron": "string",
    "runs": "string",
    "startDate": "string"
  },
  "jobParams": {
    "fileSplitSize": "string",
    "type": "string",
    "media": [

    ],
    "exportAttachments": true
  },
  "suspended": true
}'
"https://api-demo.com/udm/v10/export/jobs/{id}?"
DELETE
/v10/export/jobs/{id}
This request is intended to delete finished job.
Parameters
Name Default Description Parameter Type Data Type Required
x-api-key API key provided by Genesys. UDM deployments are accessed through GAPI-based URLs, for example, https://gapi-use1.genesyscloud.com/udm header string
id path string true
Authorization Bearer token in the format, Authorization: Bearer <GAuth token>. See details about GAuth token. header string Yes
Responses
Code Reason
204 204 response
400 400 response
Usage
curl -X DELETE
-H "x-api-key: your_API_key"
-H "Content-Type: application/json"
-H "Authorization: Bearer eyJhbGciOiJSU...afA1Q"
"https://api-demo.com/udm/v10/export/jobs/{id}?"
GET
/v10/file-metadatas
This request is intended to get a list of files data.
Parameters
Name Default Description Parameter Type Data Type Required
historyId query string
descAsc query string
jobTitle query string
x-api-key query string
name query string
type query string
source query string
endDate query string
orderField query string
startDate query string
from query string
size query string
bgUpdate query string
Authorization Bearer token in the format, Authorization: Bearer <GAuth token>. See details about GAuth token. header string Yes
Responses
Code Reason
200 200 response 
{
  "count": 0,
  "from": 0,
  "items": [

  ],
  "size": 0
}
items
PagedResponse
count (integer):
from (integer):
items (array:object):
size (integer):
Usage
curl -X GET
-H "x-api-key: your_API_key"
-H "Content-Type: application/json"
-H "Authorization: Bearer eyJhbGciOiJSU...afA1Q"
"https://api-demo.com/udm/v10/file-metadatas?historyId=string&descAsc=string&jobTitle=string&name=string&type=string&source=string&endDate=string&orderField=string&startDate=string&from=string&size=string&bgUpdate=string"
GET
/v10/files
This request is intended to get a bunch of links to download files.
Parameters
Name Default Description Parameter Type Data Type Required
filename query string
x-api-key API key provided by Genesys. UDM deployments are accessed through GAPI-based URLs, for example, https://gapi-use1.genesyscloud.com/udm header string
Authorization Bearer token in the format, Authorization: Bearer <GAuth token>. See details about GAuth token. header string Yes
Responses
Code Reason
200 200 response 
{
  "path": "string"
}
PreSignedUri
path (string):
400 400 response
404 404 response 
{}
Usage
curl -X GET
-H "x-api-key: your_API_key"
-H "Content-Type: application/json"
-H "Authorization: Bearer eyJhbGciOiJSU...afA1Q"
"https://api-demo.com/udm/v10/files?filename=string"
DELETE
/v10/files
This request is intended to delete a bunch of files.
Parameters
Name Default Description Parameter Type Data Type Required
filename query string true
x-api-key API key provided by Genesys. UDM deployments are accessed through GAPI-based URLs, for example, https://gapi-use1.genesyscloud.com/udm header string
Authorization Bearer token in the format, Authorization: Bearer <GAuth token>. See details about GAuth token. header string Yes
Responses
Code Reason
204 204 response
Usage
curl -X DELETE
-H "x-api-key: your_API_key"
-H "Content-Type: application/json"
-H "Authorization: Bearer eyJhbGciOiJSU...afA1Q"
"https://api-demo.com/udm/v10/files?filename=string"
GET
/v10/files/{filename}
This request is intended to download a file.
Parameters
Name Default Description Parameter Type Data Type Required
filename path string true
x-api-key API key provided by Genesys. UDM deployments are accessed through GAPI-based URLs, for example, https://gapi-use1.genesyscloud.com/udm header string
Authorization Bearer token in the format, Authorization: Bearer <GAuth token>. See details about GAuth token. header string Yes
Responses
Code Reason
303 303 response
404 404 response
Usage
curl -X GET
-H "x-api-key: your_API_key"
-H "Content-Type: application/json"
-H "Authorization: Bearer eyJhbGciOiJSU...afA1Q"
"https://api-demo.com/udm/v10/files/{filename}?"
DELETE
/v10/files/{filename}
This request is intended to delete a file.
Parameters
Name Default Description Parameter Type Data Type Required
filename path string true
x-api-key API key provided by Genesys. UDM deployments are accessed through GAPI-based URLs, for example, https://gapi-use1.genesyscloud.com/udm header string
Authorization Bearer token in the format, Authorization: Bearer <GAuth token>. See details about GAuth token. header string Yes
Responses
Code Reason
204 204 response
Usage
curl -X DELETE
-H "x-api-key: your_API_key"
-H "Content-Type: application/json"
-H "Authorization: Bearer eyJhbGciOiJSU...afA1Q"
"https://api-demo.com/udm/v10/files/{filename}?"
GET
/v10/resources/labels
This request is intended to get labels and their values.
Responses
Code Reason
200 200 response
Usage
curl -X GET
-H "x-api-key: your_API_key"
-H "Content-Type: application/json"
-H "Authorization: Bearer eyJhbGciOiJSU...afA1Q"
"https://api-demo.com/udm/v10/resources/labels?"
GET
/v10/version
This request is intended to get service info.
Parameters
Name Default Description Parameter Type Data Type Required
x-api-key API key provided by Genesys. UDM deployments are accessed through GAPI-based URLs, for example, https://gapi-use1.genesyscloud.com/udm header string
Responses
Code Reason
200 200 response 
{
  "version": "string",
  "buildNumber": "string",
  "changeset": "string",
  "name": "string"
}
VersionInfo
version (string):
buildNumber (string):
changeset (string):
name (string):
Usage
curl -X GET
-H "x-api-key: your_API_key"
-H "Content-Type: application/json"
"https://api-demo.com/udm/v10/version?"


Version 4 API Requests

Important
Although the User Data Management API still supports version 4 API calls documented below, they have been deprecated.
GET
Deprecated
/v4/export/history
Get list of jobs info
Parameters
Name Default Description Parameter Type Data Type Required
descAsc Specifies the sort order of orderField. False for ascending order, true for descending query boolean
orderField By which field to order query string
title Filter that title contains query string
fileName Filter that file name contains query string
type Filter that type contains query string
status Filter that file name contains query string
from 0 Index of the first item to return query integer
size 999999999 Maximum number of items to return query integer
Responses
Code Reason
200 Ok 
{
  "count": 0,
  "from": 0,
  "items": [

  ],
  "size": 0
}
PagedResponse
count (integer):
from (integer):
items (array:object):
size (integer):
204 No Content
Usage
curl -X GET
-H "x-api-key: your_API_key"
-H "Content-Type: application/json"

"https://api-demo.com/udm/v4/export/history?descAsc=true&orderField=string&title=string&fileName=string&type=string&status=string&from=0&size=0"
DELETE
Deprecated
/v4/export/history
Delete the specified jobs list

In case if some jobs cannot be deleted internal server error is returned with a list of jobs that weren't deleted as json array in the body. A job with status in progress cannot be deleted.

Parameters
Name Default Description Parameter Type Data Type Required
jobIDs A comma-separated list of job IDs query string true
Responses
Code Reason
204 No Content
400 Bad Request
Usage
curl -X DELETE
-H "x-api-key: your_API_key"
-H "Content-Type: application/json"

"https://api-demo.com/udm/v4/export/history?jobIDs=string"
GET
Deprecated
/v4/export/history/{id}
Get specified jobs history
Parameters
Name Default Description Parameter Type Data Type Required
id The id of the job path string true
Responses
Code Reason
200 Ok 
{
  "id": 0,
  "type": "string",
  "source": "string",
  "title": "string",
  "fileSplitSize": "string",
  "fileName": "string",
  "fileSize": 0,
  "status": "string",
  "createdDate": "string",
  "dateFrom": "string",
  "dateTo": "string",
  "description": "string",
  "media": [

  ],
  "progress": 0,
  "parentId": 0
}
JobInfo
id (integer):
type (string):
source (string):
title (string):
fileSplitSize (string):
filename (string):
fileSize (integer):
status (string):
createdDate (string):
dateFrom (string):
dateTo (string):
description (string):
media (array:string):
progress (integer):
parentId (integer):
400 Bad Request
404 ManualJob Not Found
Usage
curl -X GET
-H "x-api-key: your_API_key"
-H "Content-Type: application/json"

"https://api-demo.com/udm/v4/export/history/{id}?"
DELETE
Deprecated
/v4/export/history/{id}
Delete the specified job

A job in progress can not be deleted.

Parameters
Name Default Description Parameter Type Data Type Required
id The id of the job path string true
Responses
Code Reason
204 No Content
400 Bad Request
Usage
curl -X DELETE
-H "x-api-key: your_API_key"
-H "Content-Type: application/json"

"https://api-demo.com/udm/v4/export/history/{id}?"
GET
Deprecated
/v4/export/history/{id}/progress
Get currently running job completion progress

Return value is between 0 and 100 percent.

Parameters
Name Default Description Parameter Type Data Type Required
id The id of the job history path string true
Responses
Code Reason
200 Ok 
{
  "progress": 0,
  "status": "string"
}
JobProgress
progress (integer):
status (string):
400 Bad Request
Usage
curl -X GET
-H "x-api-key: your_API_key"
-H "Content-Type: application/json"

"https://api-demo.com/udm/v4/export/history/{id}/progress?"
GET
Deprecated
/v4/export/jobs
Get list of jobs info
Parameters
Name Default Description Parameter Type Data Type Required
descAsc Specifies the sort order of orderField. False for ascending order, true for descending query boolean
orderField By which field to order query string
title Filter that title contains query string
type Filter that type contains query string
scheduleType Filter that file name contains query string
suspend Filter that schedule type contains query boolean
from 0 Index of the first item to return query integer
size 999999999 Maximum number of items to return query integer
Responses
Code Reason
200 Ok 
{
  "count": 0,
  "from": 0,
  "items": [

  ],
  "size": 0
}
PagedResponse
count (integer):
from (integer):
items (array:object):
size (integer):
204 No Content
Usage
curl -X GET
-H "x-api-key: your_API_key"
-H "Content-Type: application/json"

"https://api-demo.com/udm/v4/export/jobs?descAsc=true&orderField=string&title=string&type=string&scheduleType=string&suspend=true&from=0&size=0"
POST
Deprecated
/v4/export/jobs
Save specified manualJob
Parameters
Name Default Description Parameter Type Data Type Required
body body 
{
  "source": "string",
  "title": "string",
  "timeFrame": {
    "all": true,
    "dateFrom": "string",
    "dateTo": "string"
  },
  "fileSplitSize": "string",
  "description": "string",
  "schedulerParam": {
    "immediately": true,
    "cron": "string",
    "runs": "string",
    "startDate": "string"
  },
  "jobParams": {
    "fileSplitSize": "string",
    "type": "string",
    "media": [

    ]
  },
  "suspended": "string"
}
TimeFrame
all (boolean, optional):
dateFrom (string, optional):
dateTo (string, optional):
SchedulerParam
immediately (boolean, optional):
cron (string, optional):
runs (string, optional):
startDate (string, optional):
UcsJobParams
fileSplitSize (string, optional):
type (string, required):
media (array:string, required):
Job
source (string, required): source of job
title (string, required): title of job
timeFrame (TimeFrame, required): export time parameter of job
fileSplitSize (string, optional): size of splitted file
description (string, optional): A description
schedulerParam (SchedulerParam, required): scheduler parameter of job
jobParams (UcsJobParams, required): parameters of job
suspended (string, required): suspended job
Responses
Code Reason
202 Accepted 
{
  "id": 0,
  "type": "string",
  "source": "string",
  "title": "string",
  "fileSplitSize": "string",
  "fileName": "string",
  "fileSize": 0,
  "status": "string",
  "createdDate": "string",
  "dateFrom": "string",
  "dateTo": "string",
  "description": "string",
  "media": [

  ],
  "progress": 0,
  "parentId": 0
}
JobInfo
id (integer):
type (string):
source (string):
title (string):
fileSplitSize (string):
fileName (string):
fileSize (integer):
status (string):
createdDate (string):
dateFrom (string):
dateTo (string):
description (string):
media (array:string):
progress (integer):
parentId (integer):
400 Bad Request
Usage
curl -X POST
-H "x-api-key: your_API_key"
-H "Content-Type: application/json"
-d '{
  "source": "string",
  "title": "string",
  "timeFrame": {
    "all": true,
    "dateFrom": "string",
    "dateTo": "string"
  },
  "fileSplitSize": "string",
  "description": "string",
  "schedulerParam": {
    "immediately": true,
    "cron": "string",
    "runs": "string",
    "startDate": "string"
  },
  "jobParams": {
    "fileSplitSize": "string",
    "type": "string",
    "media": [

    ]
  },
  "suspended": "string"
}'
"https://api-demo.com/udm/v4/export/jobs?"
DELETE
Deprecated
/v4/export/jobs
Delete the specified jobs list

In case if some jobs cannot be deleted internal server error is returned with a list of jobs that weren't deleted as json array in the body. A job with status in progress cannot be deleted.

Parameters
Name Default Description Parameter Type Data Type Required
jobIDs A comma-separated list of job IDs query string true
Responses
Code Reason
204 No Content
400 Bad Request
Usage
curl -X DELETE
-H "x-api-key: your_API_key"
-H "Content-Type: application/json"

"https://api-demo.com/udm/v4/export/jobs?jobIDs=string"
POST
Deprecated
/v4/export/jobs/cancel/{id}
Cancel running
Parameters
Name Default Description Parameter Type Data Type Required
id The id of the job path string true
Responses
Code Reason
200 Ok
400 Bad Request
404 Not Found
Usage
curl -X POST
-H "x-api-key: your_API_key"
-H "Content-Type: application/json"

"https://api-demo.com/udm/v4/export/jobs/cancel/{id}?"
POST
Deprecated
/v4/export/jobs/resume/{id}
Save specified manualJob
Parameters
Name Default Description Parameter Type Data Type Required
id The id of the job path string true
Responses
Code Reason
200 Ok 
{
    "status": {
        "code": 0,
        "detail": {},
        "message": "successful"
    }
}
400 Bad Request
404 Job Not Found
Usage
curl -X POST
-H "x-api-key: your_API_key"
-H "Content-Type: application/json"

"https://api-demo.com/udm/v4/export/jobs/resume/{id}?"
POST
Deprecated
/v4/export/jobs/suspend/{id}
Save specified manualJob
Parameters
Name Default Description Parameter Type Data Type Required
id The id of the job path string true
Responses
Code Reason
200 Ok 
{
    "status": {
        "code": 0,
        "detail": {},
        "message": "successful"
    }
}
400 Bad Request
404 Job Not Found
Usage
curl -X POST
-H "x-api-key: your_API_key"
-H "Content-Type: application/json"

"https://api-demo.com/udm/v4/export/jobs/suspend/{id}?"
GET
Deprecated
/v4/export/jobs/{id}
Get specified job
Parameters
Name Default Description Parameter Type Data Type Required
id The id of the job path string true
Responses
Code Reason
200 Ok 
{
  "id": "",
  "source": "string",
  "title": "string",
  "timeFrame": {
    "all": true,
    "dateFrom": "string",
    "dateTo": "string"
  },
  "fileSplitSize": "string",
  "description": "string",
  "schedulerParam": {
    "immediately": true,
    "cron": "string",
    "runs": "string",
    "startDate": "string"
  },
  "jobParams": {
    "fileSplitSize": "string",
    "type": "string",
    "media": [
]
  },
  "suspended": "string"
}
400 Bad Request
404 ManualJob Not Found
Usage
curl -X GET
-H "x-api-key: your_API_key"
-H "Content-Type: application/json"

"https://api-demo.com/udm/v4/export/jobs/{id}?"
PUT
Deprecated
/v4/export/jobs/{id}
Save specified manualJob
Parameters
Name Default Description Parameter Type Data Type Required
id path string true
body body 
{
  "source": "string",
  "title": "string",
  "type": "string",
  "timeFrame": {
    "all": true,
    "dateFrom": "string",
    "dateTo": "string"
  },
  "fileSplitSize": "string",
  "description": "string",
  "schedulerParam": {
    "immediately": true,
    "cron": "string",
    "runs": "string",
    "startDate": "string"
  },
  "jobParams": {
    "fileSplitSize": "string",
    "type": "string",
    "media": [

    ]
  },
  "suspended": "string"
}
TimeFrame
all (boolean, optional):
dateFrom (string, optional):
dateTo (string, optional):
SchedulerParam
immediately (boolean, optional):
cron (string, optional):
runs (string, optional):
startDate (string, optional):
UcsJobParams
fileSplitSize (string, optional):
type (string, required):
media (array:string, required):
Job
source (string, required): source of job
title (string, required): title of job
type (string, required): type of job
timeFrame (TimeFrame, required): export time parameter of job
fileSplitSize (string, optional): size of splitted file
description (string, optional): A description
schedulerParam (SchedulerParam, required): scheduler parameter of job
jobParams (UcsJobParams, required): parameters of job
suspended (string, required): suspended job
Responses
Code Reason
200 Ok 
{
  "id": 0,
  "type": "string",
  "source": "string",
  "title": "string",
  "fileSplitSize": "string",
  "fileName": "string",
  "fileSize": 0,
  "status": "string",
  "createdDate": "string",
  "dateFrom": "string",
  "dateTo": "string",
  "description": "string",
  "media": [

  ],
  "progress": 0,
  "parentId": 0
}
JobInfo
id (integer):
type (string):
source (string):
title (string):
fileSplitSize (string):
fileName (string):
fileSize (integer):
status (string):
createdDate (string):
dateFrom (string):
dateTo (string):
description (string):
media (array:string):
progress (integer):
parentId (integer):
400 Bad Request
404 Job Not Found
Usage
curl -X PUT
-H "x-api-key: your_API_key"
-H "Content-Type: application/json"
-d '{
  "source": "string",
  "title": "string",
  "timeFrame": {
    "all": true,
    "dateFrom": "string",
    "dateTo": "string"
  },
  "fileSplitSize": "string",
  "description": "string",
  "schedulerParam": {
    "immediately": true,
    "cron": "string",
    "runs": "string",
    "startDate": "string"
  },
  "jobParams": {
    "fileSplitSize": "string",
    "type": "string",
    "media": [

    ]
  },
  "suspended": "string"
}'
"https://api-demo.com/udm/v4/export/jobs/{id}?"
DELETE
Deprecated
/v4/export/jobs/{id}
Delete the specified job

A job in progress can not be deleted.

Parameters
Name Default Description Parameter Type Data Type Required
id The id of the job path string true
Responses
Code Reason
204 No Content
400 Bad Request
Usage
curl -X DELETE
-H "x-api-key: your_API_key"
-H "Content-Type: application/json"

"https://api-demo.com/udm/v4/export/jobs/{id}?"

Version 3 API Requests

Important
Although the User Data Management API still supports version 3 API calls documented below, they have been deprecated.
GET
Deprecated
/v3/cipher
Get certificate information
Responses
Code Reason
200 Ok 
{
  "ccid": "string",
  "name": "string",
  "size": 0,
  "lastModified": "string"
}
CertificateInfo
ccid (string):
name (string):
size (integer):
lastModified (string):
Usage
curl -X GET
-H "x-api-key: your_API_key"
-H "Content-Type: application/json"

"https://api-demo.com/udm/v3/cipher?"
POST
Deprecated
/v3/cipher/{certificatefilename}
POST the specified certificate
Parameters
Name Default Description Parameter Type Data Type Required
certificatefilename path string true
file formData file
Responses
Code Reason
201 Created 
"string"
400 Bad Request
Usage
curl -X POST
-H "x-api-key: your_API_key"
-H "Content-Type: application/json"

"https://api-demo.com/udm/v3/cipher/{certificatefilename}?"
GET
Deprecated
/v3/data/job-statuses
Get list of job statuses
Responses
Code Reason
200 Ok 
[
  {
    "label": "string",
    "value": "string"
  }
]
KeyValueItem
label (string):
value (string):
Usage
curl -X GET
-H "x-api-key: your_API_key"
-H "Content-Type: application/json"

"https://api-demo.com/udm/v3/data/job-statuses?"
GET
Deprecated
/v3/data/sources
Get list of sources
Responses
Code Reason
200 Ok 
[
  {
    "label": "string",
    "value": "string"
  }
]
KeyValueItem
label (string):
value (string):
204 No Content
Usage
curl -X GET
-H "x-api-key: your_API_key"
-H "Content-Type: application/json"

"https://api-demo.com/udm/v3/data/sources?"
GET
Deprecated
/v3/data/sub-types
Get list of data subtypes
Parameters
Name Default Description Parameter Type Data Type Required
source Filter data sub types by source query string
dataType Filter data types by type query string
Responses
Code Reason
200 Ok 
[
  {
    "name": "string",
    "displayName": "string",
    "source": "string",
    "dataType": "string",
    "enabled": true
  }
]
SubType
name (string):
displayName (string):
source (string):
dataType (string):
enabled (boolean):
204 No Content
400 Bad Request
Usage
curl -X GET
-H "x-api-key: your_API_key"
-H "Content-Type: application/json"

"https://api-demo.com/udm/v3/data/sub-types?source=string&dataType=string"
GET
Deprecated
/v3/data/types
Get list of types
Parameters
Name Default Description Parameter Type Data Type Required
source Filter data types by source query string
Responses
Code Reason
200 Ok 
[
  {
    "name": "string",
    "source": "string"
  }
]
DataType
name (string):
source (string):
204 No Content
Usage
curl -X GET
-H "x-api-key: your_API_key"
-H "Content-Type: application/json"

"https://api-demo.com/udm/v3/data/types?source=string"
GET
Deprecated
/v3/file-metadatas
Get list of files metadata
Parameters
Name Default Description Parameter Type Data Type Required
descAsc Specifies the sort order of orderField. False for ascending order, true for descending query boolean
orderField By which field to order query string
startDate startDate query string
endDate Filter to which upload date query string
name Filter that file name contains query string
jobTitle Filter that job title contains query string
type Filter that file type contains query string
from 0 Index of the first item to return query integer
size 999999999 Maximum number of items to return query integer
Responses
Code Reason
200 Ok 
{
  "count": 0,
  "from": 0,
  "items": [

  ],
  "size": 0
}
PagedResponse
count (integer):
from (integer):
items (array:object):
size (integer):
Usage
curl -X GET
-H "x-api-key: your_API_key"
-H "Content-Type: application/json"

"https://api-demo.com/udm/v3/file-metadatas?descAsc=true&orderField=string&startDate=string&endDate=string&name=string&jobTitle=string&type=string&from=0&size=0"
GET
Deprecated
/v3/files
Get the list of pre-signed url for specified files list

The maximum number of files is limited to 100. Also if some files cannot be found HTTP 404 is returned with a list of the files that weren’t found as json array in the body

Parameters
Name Default Description Parameter Type Data Type Required
filename A comma-separated list of file names query string
Responses
Code Reason
200 Ok 
{
  "path": "string"
}
PreSignedUri
path (string):
400 Bad Request
404 File Not Found 
[
  {
    "path": "string"
  }
]
PreSignedUri
path (string):
Usage
curl -X GET
-H "x-api-key: your_API_key"
-H "Content-Type: application/json"

"https://api-demo.com/udm/v3/files?filename=string"
DELETE
Deprecated
/v3/files
Delete the specified files list

In case if some files cannot be deleted internal server error is returned with a list of files that weren’t deleted as json array in the body.

Parameters
Name Default Description Parameter Type Data Type Required
filename A comma-separated list of file names query string true
Responses
Code Reason
204 No Content
Usage
curl -X DELETE
-H "x-api-key: your_API_key"
-H "Content-Type: application/json"

"https://api-demo.com/udm/v3/files?filename=string"
GET
Deprecated
/v3/files/{filename}
Get the specified file
Parameters
Name Default Description Parameter Type Data Type Required
filename The name of the file path string true
Responses
Code Reason
303 See Other
404 File Not Found
Usage
curl -X GET
-H "x-api-key: your_API_key"
-H "Content-Type: application/json"

"https://api-demo.com/udm/v3/files/{filename}?"
DELETE
Deprecated
/v3/files/{filename}
Delete the specified file
Parameters
Name Default Description Parameter Type Data Type Required
filename The name of the file path string true
Responses
Code Reason
204 No Content
Usage
curl -X DELETE
-H "x-api-key: your_API_key"
-H "Content-Type: application/json"

"https://api-demo.com/udm/v3/files/{filename}?"
GET
Deprecated
/v3/version
Get version information
Responses
Code Reason
200 Ok 
{
  "version": "string",
  "buildNumber": "string",
  "changeset": "string",
  "name": "string"
}
VersionInfo
version (string):
buildNumber (string):
changeset (string):
name (string):
Usage
curl -X GET
-H "x-api-key: your_API_key"
-H "Content-Type: application/json"

"https://api-demo.com/udm/v3/version?"
Retrieved from "https://all.docs.genesys.com/PEC-Developer/Current/WebAPIs/UDM_Data-download (2025-07-14 04:27:19)"
Comments or questions about this documentation? Contact us for support!