Viviot.Api

PutThingStates

**Requires Authentication**
Requires any of the roles:	Admin, TenantAdmin, Receptionist

The following routes are available for this service:
PUT	/thing/states	Updates state(s) of individual things (as a business user).

**PutThingStates** Parameters:
Name	Parameter	Data Type	Required	Description
ThingId	body	string	Yes	Thing Id (GUID).
States	body	List<StateValue>	Yes	List of state names and their values.
Properties	body	Dictionary<string, string>	No	Dictionary with key value pairs of all thing properties.

**BaseRequest** Parameters:
Name	Parameter	Data Type	Required	Description
Version	form	integer	No	Api version

**StateValue** Parameters:
Name	Parameter	Data Type	Required	Description
Name	form	string	No
Value	form	string	No

**ThingStatesResponse** Parameters:
Name	Parameter	Data Type	Required	Description
Data	form	ThingStateView	No

**BaseResponse** Parameters:
Name	Parameter	Data Type	Required	Description
ResponseStatus	form	ResponseStatus	No

**ThingStateView** Parameters:
Name	Parameter	Data Type	Required
ThingId	form	Guid	No
OrganizationId	form	Guid	No
Properties	form	Dictionary<string, Object>	No
States	form	Dictionary<string, List<StateValueView>>	No
ChildThings	form	List<ThingStateView>	No

To override the Content-type in your clients, use the HTTP Accept Header, append the .csv suffix or ?format=csv

HTTP + CSV

The following are sample HTTP requests and responses. The placeholders shown need to be replaced with actual values.

PUT /thing/states HTTP/1.1 
Host: api.4spaces.io 
Accept: text/csv
Content-Type: text/csv
Content-Length: length

{"thingId":"00000000000000000000000000000000","states":[{"name":"String","value":"String"}],"properties":{"String":"String"},"version":0}

HTTP/1.1 200 OK
Content-Type: text/csv
Content-Length: length

{"data":{"thingId":"00000000000000000000000000000000","organizationId":"00000000000000000000000000000000","properties":{"String":{}},"states":{"String":[{"ts":-62135596800000,"value":"String"}]},"childThings":[{"thingId":"00000000000000000000000000000000","organizationId":"00000000000000000000000000000000","properties":{"String":{}},"states":{"String":[{"ts":-62135596800000,"value":"String"}]},"childThings":[{"thingId":"00000000000000000000000000000000","organizationId":"00000000000000000000000000000000","properties":{"String":{}},"states":{"String":[{"ts":-62135596800000,"value":"String"}]},"childThings":[{}]}]}]},"responseStatus":{"errorCode":"String","message":"String","stackTrace":"String","errors":[{"errorCode":"String","fieldName":"String","message":"String","meta":{"String":"String"}}],"meta":{"String":"String"}}}