Create a user to thing authorization

Prev Next
Post
/inventory/userThingAuthorizations

Set the authorization of the user on a specific thing.

Required permissions: READ_USER_AUTHORIZATION, WRITE_USER_AUTHORIZATION.

Security
HTTP
Type bearer
Header parameters
X-Servitly-Tenant
stringRequired

The name of the target tenant (e.g. acme).

Body parameters

The information describing the user to thing authorization.

Expand All
object
userId
string

The identifier of the user associated to this authorization.

thingId
string

The identifier of the thing associated to this authorization.

authorization
string

The authorization of the user on the thing.

Valid values[ "GRANT", "DENY" ]
userTypeId
string

The identifier of the user-type the user impersonate when operating on the associated thing.

limitedTime
object

The time limitation of this authorization.

startDayTime
number

The day time the authorization starts (e.g. 10:00 -> 1000). The default value is 0.

Example1000
endDayTime
number

The day time the authorization ends (e.g. 20:30 -> 2230). The default value is 2359.

Example2230
weekDays
Array of string

The list of week days the authorization is valid.

string
Valid values[ "MONDAY", "TUESDAY", "WEDNESDAY", "THURSDAY", "FRIDAY", "SATURDAY", "SUNDAY" ]
startTimestamp
integer (int64)

The timestamp UTC the authorization starts.

Example1578438000000
endTimestamp
integer (int64)

The timestamp UTC the authorization ends.

Example1578438000000
Responses
200

Successful created.

400

Request data not valid.

object
message
string

The error response.

ExampleBad request
401

User not authenticated.

object
message
string

The error response.

ExampleUser not authenticated
403

User not authorized.

object
message
string

The error response.

ExampleUser not authorized
404

Resource was not found.

object
message
string

The error response.

ExampleResource not found
429

API call rate limit exeeded.

object
message
string

The error response.

ExampleAPI call rate limit exeeded
500

Internal server error.

object
message
string

The error response.

ExampleInternal Server Error