This section contains API details that are common to every API’s resource and action.

Request Headers

Header Description
Authorization Contains token string to allow request authentication and authorization.
If-Match Contains data revision as known by the client. Allows to optimize the backend, networking and client resources utilization.

Response Headers

Header Description
eTag This parameter specifies the version of the data object retrieved. You can use the If-Match parameter in the request to retrieve a specifc version using this parameter's value..
location URI Location of the newly created resource. This header is included only when the request created single object.

Query Parameters

Parameter Description Notes Required
v API version number Type: Double. Default Value: 1.0 (Most updated: v=4.0) Required
select Dynamic selection of the response fields Type: YOGA 'gdata' dialect. Non-existing field: no error, blank in response. Supported fields: Any in response body. YOGA GData dialect builder url: https://github.com/skyscreamer/yoga/wiki/Using-the-Selector-Builder-GUI Optional
include_deleted Whether or not deleted items in the response are included Default: false Optional

Path Parameters

Parameter Description Type
accountId LP site ID String
userId User ID Positive long number greater than zero
skillId Skill ID Positive long number greater than zero
agentGroupId Agent group ID Positive long number greater than zero
lobId LOB ID Positive long number greater than zero

Entity Structure

Attribute Description Type/Value Required Notes
id Lines of business unique ID long number Read only  
deleted Whether the item is deleted or not Boolean Read only  
name Lines of business's unique name string Required  
description The lines of business's description string Optional  
dateUpdated The last update lines of business change date Date (numbers) Optional The format: year-month-date hrs:min:sec

Entity Example

    {
      "id":2398413012,
      "name":"test",
      "deleted":false,
      "dateUpdated":"2017-10-26 18:29:22"
    }

Data Revisions

The revision mechanism exists in order to maintain order and save historical data. To use the benefits of the revision mechanism, The developers are asked to add the 'IF-MATCH' request header. The 'IF-MATCH' request header contains data revision as known by the client, In addition, it allows to optimize the backend response and allows concurrent modification backend verification.

Every entity will have only one latest revision and the maximum revision number is a global number by account. Each change/update on one of these entities increases The revision. The developer can call the GET entity API in order to retrieve the latest revision. This revision will be part of the response header under ac-revision header.

When sending the API calls using the 'IF-MATCH' header with a specific revision if there was no change the response will be 304 (Not Modified) response. When using 'IF-MATCH' header with '-1' value you will always get the full response.