(Quick Reference) Service: Update

Description: This web service is used to update an existing assigned item group object to the database

Method: PUT

Request content type: application/json




NameDescriptionTypeRequiredExample values
idid of the desired assigned item group to updateLongYes111
groupIdthe id of the item group to be assignedLongYes777
itemIdthe id of the new item group to assign to an itemGroupLongYes123

URL with external_id:



NameDescriptionTypeRequiredExamples values
itemIdreference of the itemStringYesI-002
groupIdreference of the item groupStringYesIG-001

Success Output

Success case: response.status=200
    "id": 159,
    "itemReference": "R-A-001",
    "itemGroupReference": "RG-1",
    "item": {
        "id": 1751,
        "reference": "R-A-001",
        "name": "article1",
        "href": "/api/v1.0/items/1751"
    "itemGroup": {
        "id": 21,
        "reference": "RG-1",
        "name": "ItemGroup1",
        "href": "/api/v1.0/itemGroups/21"
    "organization": "Lyon",
    "dateCreated": "2016-08-23T11:23:27Z",
    "lastUpdated": "2016-08-23T11:57:22Z"

Failure Output

Failure case:response.status = 400
    "error": "missing_param",
    "error_description": "groupId parameter is missing"
    "error": "already_assigned",
    "error_description": "item is already assigned to itemGroup."
    "error": "invalid_param_type",
    "error_description": "The type of parameter id you provided is not valid for this request."
     "error": "save_failed",
     "error_description": "Failed to save instance"

Failure case:response.status = 404
    "error": "not_found",
    "error_description": "The item group with the id 999 doesn't exist."

Failure case:response.status = 500
    "error": "server_error",
    "error_description": "Oops! Something went wrong..."