POST api/v1/account/users/{userId}/locations/{locationId}/homeCard

Update user prefered HomeCard order. "Please Ignore Status parameter for POST method, that parameter only required for GET method"

Request Information

URI Parameters

NameDescriptionTypeAdditional information
userId

User ID

integer

Required

locationId

Location ID

integer

Required

Body Parameters

List of Device sort order

DeviceOrder
NameDescriptionTypeAdditional information
deviceOrderInfo

Collection of DeviceSortOrder

None.

Request Formats

application/json, text/json

Sample:
{
  "deviceOrderInfo": [
    {
      "DeviceId": 1,
      "DeviceOrder": 2,
      "DeviceClassId": 3,
      "DeviceInfo": [
        {
          "ChildDeviceID": 1,
          "ChildDeviceType": 2
        },
        {
          "ChildDeviceID": 1,
          "ChildDeviceType": 2
        }
      ],
      "Status": {}
    },
    {
      "DeviceId": 1,
      "DeviceOrder": 2,
      "DeviceClassId": 3,
      "DeviceInfo": [
        {
          "ChildDeviceID": 1,
          "ChildDeviceType": 2
        },
        {
          "ChildDeviceID": 1,
          "ChildDeviceType": 2
        }
      ],
      "Status": {}
    }
  ]
}

application/xml, text/xml

Sample:
<DeviceOrder xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/TC2Domain">
  <deviceOrderInfo>
    <DeviceSortOrder>
      <DeviceClassId>3</DeviceClassId>
      <DeviceId>1</DeviceId>
      <DeviceInfo>
        <ChildDeviceInfo>
          <ChildDeviceID>1</ChildDeviceID>
          <ChildDeviceType>2</ChildDeviceType>
        </ChildDeviceInfo>
        <ChildDeviceInfo>
          <ChildDeviceID>1</ChildDeviceID>
          <ChildDeviceType>2</ChildDeviceType>
        </ChildDeviceInfo>
      </DeviceInfo>
      <DeviceOrder>2</DeviceOrder>
      <Status />
    </DeviceSortOrder>
    <DeviceSortOrder>
      <DeviceClassId>3</DeviceClassId>
      <DeviceId>1</DeviceId>
      <DeviceInfo>
        <ChildDeviceInfo>
          <ChildDeviceID>1</ChildDeviceID>
          <ChildDeviceType>2</ChildDeviceType>
        </ChildDeviceInfo>
        <ChildDeviceInfo>
          <ChildDeviceID>1</ChildDeviceID>
          <ChildDeviceType>2</ChildDeviceType>
        </ChildDeviceInfo>
      </DeviceInfo>
      <DeviceOrder>2</DeviceOrder>
      <Status />
    </DeviceSortOrder>
  </deviceOrderInfo>
</DeviceOrder>

application/x-www-form-urlencoded

Sample:

Sample not available.

Response Information

Resource Description

BaseResults

BaseResults
NameDescriptionTypeAdditional information
ResultCode

integer

None.

ResultData

string

None.

Response Formats

application/json, text/json

Sample:
{
  "ResultCode": 1,
  "ResultData": "sample string 2"
}

application/xml, text/xml

Sample:
<BaseResults xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/TC2Utilities.RestApi">
  <ResultCode>1</ResultCode>
  <ResultData>sample string 2</ResultData>
</BaseResults>