Remove a phone

DELETE

/v1/devices/{deviceId}

const url = 'https://your-machine.your-tailnet.ts.net/v1/devices/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 https://your-machine.your-tailnet.ts.net/v1/devices/example \
  --header 'Authorization: Bearer <token>'

Disconnects it and deletes its credentials. It has to be paired again to come back.

Authorizations

bearer
apiKey

Parameters

Path Parameters

deviceId

required

string

Responses

204

Removed.

404

Not found.

application/json

object

error

required

object

code

required

string

message

required

string

issues

Validation details

Array

Example

{
  "error": {
    "code": "NOT_FOUND",
    "message": "call not found"
  }
}