Description

Create new status reason for an account. It is possible to create several items at a time.

URI

Method URL
POST https://{domain}/api/account/{accountId}/configuration/le-agents/status-reasons

Path Parameters

Parameter Description Notes
accountId LP site id Type: String

Request

Request Headers

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

Request Body

The request body is able to accept a single JSON object as shown below, or a JSON array [] of such objects.

Note: The order attribute is not mandatory, however you should note the following:

  1. If order is not passed and there are multiple items in the request, order assigned by the server is not guaranteed to be the sorting order in the request body.

  2. Created items where order was not defined will always precede existing one.

Single status reason creation

{
  "text":"some new reason text",
  "state":"Away",
  "enabled":true,
  "deleted":false
}

Multiple status reasons creation

[
  {
    "text":"some reason text",
    "state":"Away",
    "enabled":true,
    "deleted":false
  },
  {
    "text":"another reason text",
    "state":"Away",
    "enabled":true,
    "deleted":false
  }
]
Attribute Description Notes
id Account Config object’s unique id. <ul><li>Not used when creating items, the id will be auto generated and returned as part of the response items </li><li>Type: long number </li>

Response

Response Headers

Header Description
ac-revision 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.

Response Body

Newly created status reason JSON.

Response Codes

Code Description
200 OK
400 Bad Request
401 Not Authenticated
403 Not Authorized
404 Data not found
500 Internal server error