This document describes and details Conversational Cloud's Agent Status Reason backend logic. It includes a description of the capabilities and methods of the Agent Status Reason API as well as a description of the standard "Agent Status object" which Conversational Cloud's backend uses to describe agent status. This object includes the Status Reason and is the object these methods will be querying and manipulating.

The intended purpose of the Agent Status Reason API is to allow the addition of additional away statuses and reasons. Using it, you could add to the pre-configured status reasons that come with Conversational Cloud, creating your own, querying the status reasons of your agents in bulk and more.

Getting Started

A few things you'll need to get started with this API:

  1. Retrieve your domain. Use the LivePerson Domain API to retrieve this information by providing the following service name:
  • Read only: accountConfigReadOnly

  • Read/Write: accountConfigReadWrite

  1. This API requires authorization using either a login or an API key methodology.

    • Log a user into Conversational Cloud using the Login Service API. Provide a username and password, and receive an authorization token (bearer). Use this token as your authorization header in all API requests.

    • Follow the instructions, to create and use an API key.

  2. Note the API terms of use.

General API Information

This section contains details that are common for every method of this API's resource and action.



Request Headers

Header Description
Authorization Contains token string to allow request authentication and authorization. See the authentication documentation for more details.

Query Parameters

Parameter Description Notes
v api version number
  • Required
  • Type: Double
  • Default Value: 1.0
  • Validation fail error code: 400

Status reason object description

This is the expected and general format for an Agent Status object, appearing in all methods of this API.

  "id": 121212,
  "text": "some text252",
  "state": "Away",
  "deleted": false,
  "enabled": true
Attribute Description Notes
id Account Config object’s unique id. Type: long number (automatically generated)
name Status reason text
  • Type: string
  • Required
  • Unique
  • Esapi validation: safeMedium String length:100
state agent state
  • type: string
  • possible values: "Online", "Occupied", "Away"
deleted Whether the item is deleted or not Type: boolean