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 .jsv suffix or ?format=jsv

HTTP + JSV

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/jsv
Content-Type: text/jsv
Content-Length: length

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

HTTP/1.1 200 OK
Content-Type: text/jsv
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
		}
	}
}