Description

Update an existing Category.

URI

/api/account/{accountId}/configuration/le-categories/categories/{categoryId}?v=2.0

HTTP Methods

PUT

Response Codes

200 OK

304 Not Modified

400 Bad Request

401 Not Authorized

403 Forbidden

404 Data not found

409 Conflict

500 Internal server error

Formats

JSON

Query Parameters

Parameter Description Notes
select dynamic selection of response fields Default: $all alias: id,deleted,name,order,proposed Available aliases: $all: id,deleted,name,order,proposed $summary: id,deleted,name type: YOGA 'gdata' dialect validation error: 400 supported fields: any in response body **yoga GData dialect builder url: https://github.com/skyscreamer/yoga/wiki/Using-the-Selector-Builder-GUI
return determine the return policy Default: effected — return only the effected category with the response body Also accepts: active — return all active (non-deleted) categories with the response body all — return all categories with the response body, including the deleted categories

Path Parameters

Parameter Description Notes
accountId LP site id Validation fail error code: 400 Type: String

Request Headers

Header Description
Authorization Contains token string to allow request authentication and authorization. See the doc for more details.
X-HTTP-Method-Override=PUT Tells to the backend this POST request is actually PUT
If-Match Contains AC Categories current revision number

Notes:

  1. Order attribute is mandatory. It is a sequential and consecutive value managed by the server.

  2. Sending a category without order value results in a BAD_REQUEST response code.

  3. Order value has to greater than zero. Failing this validation will result in a BAD_REQUEST response code.

Request Body

{ "id":11, "deleted":false, "name":"Nexus5", "order":2, ← mandatory field "proposed":true }

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. after the operation

Response Body

Updated category data, depends on the 'return’ query parameter

Update order example (based on the above request body):

Initial state:

Site contains 3 categories (id/order/name triplets): 11,1,"Nexus5”; 22,2,”IPhone5”; 33,3,”Nexus6”

After update state:

Site contains 3 categories (id/order/name triplets): 11,2,"Nexus5”; 22,1,”IPhone5”; 33,3,”Nexus6”

Note that 2 out of 3 existing order values are affected by the update operation.

Response body without return policy specified (default = EFFECTED)

[{ "id":11, "deleted":false, "name":"Nexus5", "order":2, "proposed":true },{ "id":22, "deleted":false, "name":"IPhone5", "order":1, "proposed":true }]

Response body with return policy ALL/ACTIVE

[{ "id":11, "deleted":false, "name":"Nexus5", "order":2, "proposed":true }, { "id":22, "deleted":false, "name":"IPhone5", "order":1, "proposed":true } ,{ "id":33, "deleted":false, "name":"Nexus6", "order":3, "proposed":true }]