PUT/v1/devices/{device-id}/nameSet a device name

Sets the name of a device. Organization-SuperUsers and Device-administrators can set updateForEverybody to 'true'. Everybody else should call the method with 'false', and leaving it empty will assume 'true' for backwards compatibility

header	Authorization	Authentication token (bearer token or API key).
{ "name" : String, "updateForEverybody" : Boolean }

Response

status	200	All ok
status	401	Invalid authentication token
status	403	Insufficient rights
status	404	Device not found
{}

Example: Set a global device name as an Account

PUT/v1/devices/1/name

header	Authorization	Bearer e02d13d1-a0ba-4f54-b2f6-3c4b175d7454
{ "name": "Front door", "updateForEverybody": true }

Response

status	200
header	Access-Control-Expose-Headers	authorization, content-type
header	Access-Control-Allow-Headers	authorization, content-type
header	Access-Control-Allow-Methods	GET, POST, DELETE, OPTIONS, PUT
header	Access-Control-Allow-Origin	*
header	Strict-Transport-Security	max-age=31536000; includeSubDomains
header	X-Frame-Options	SAMEORIGIN
header	X-Content-Type-Options	nosniff
header	X-XSS-Protection	1; mode=block
header	Content-Security-Policy	default-src 'none'; frame-ancestors 'none'; base-uri 'none'; form-action 'none'
header	Referrer-Policy	no-referrer
header	Feature-Policy	self
header	Permissions-policy	interest-cohort=()
{}

Example: Set a personal device name as an Account

PUT/v1/devices/1/name

header	Authorization	Bearer 873f91f2-bd07-4e97-9fc7-6d035406f2c7
{ "name": "Front door", "updateForEverybody": false }

Response

status	200
header	Access-Control-Expose-Headers	authorization, content-type
header	Access-Control-Allow-Headers	authorization, content-type
header	Access-Control-Allow-Methods	GET, POST, DELETE, OPTIONS, PUT
header	Access-Control-Allow-Origin	*
header	Strict-Transport-Security	max-age=31536000; includeSubDomains
header	X-Frame-Options	SAMEORIGIN
header	X-Content-Type-Options	nosniff
header	X-XSS-Protection	1; mode=block
header	Content-Security-Policy	default-src 'none'; frame-ancestors 'none'; base-uri 'none'; form-action 'none'
header	Referrer-Policy	no-referrer
header	Feature-Policy	self
header	Permissions-policy	interest-cohort=()
{}

Example: Fail to set a business device name as an Account

PUT/v1/devices/3/name

header	Authorization	Bearer a5e98092-8780-4d54-a19e-6ee0dbbc08dc
{ "name": "Front door", "updateForEverybody": true }

Response

status	403
header	Access-Control-Expose-Headers	authorization, content-type
header	Access-Control-Allow-Headers	authorization, content-type
header	Access-Control-Allow-Methods	GET, POST, DELETE, OPTIONS, PUT
header	Access-Control-Allow-Origin	*
header	Strict-Transport-Security	max-age=31536000; includeSubDomains
header	X-Frame-Options	SAMEORIGIN
header	X-Content-Type-Options	nosniff
header	X-XSS-Protection	1; mode=block
header	Content-Security-Policy	default-src 'none'; frame-ancestors 'none'; base-uri 'none'; form-action 'none'
header	Referrer-Policy	no-referrer
header	Feature-Policy	self
header	Permissions-policy	interest-cohort=()
{ "message": "The request was a legal request, but the server is refusing to respond to it.", "errorMessage": "The request was a legal request, but the server is refusing to respond to it." }