Remove a person
DELETE
/people/{id}
const url = 'http://127.0.0.1:7700/api/people/example';const options = {method: 'DELETE', headers: {Authorization: 'Bearer <token>'}};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request DELETE \ --url http://127.0.0.1:7700/api/people/example \ --header 'Authorization: Bearer <token>'Preview. For an admin or the owner; only the owner removes an owner. Their paired phones stop working at once.
Authorizations
Section titled “Authorizations”Parameters
Section titled “Parameters”Path Parameters
Section titled “Path Parameters”id
required
string
Responses
Section titled “Responses”Removed.
Media typeapplication/json
object
id
string
removed
boolean
Example
{ "removed": true}The owner’s route, called by someone who is not the box’s own screen or a device paired as the owner.
Media typeapplication/json
object
error
required
What went wrong
string
Example
{ "error": "only this computer's own screen or the owner's paired device can do this"}No person with this id.
Media typeapplication/json
object
error
required
What went wrong
string
Example generated
{ "error": "example"}