Profile

Trusted Device View

get
https://api.linode.com/v4/profile/devices/{deviceId}

Returns a single active TrustedDevice for your User.

Path Parameters

deviceId
Required
integer

The ID of the TrustedDevice

Request Samples

curl -H "Content-Type: application/json" \
    -H "Authorization: Bearer $TOKEN" \
    https://api.linode.com/v4/profile/devices/123

Response Samples

{
  "created": "2018-01-01T01:01:01",
  "expiry": "2018-01-31T01:01:01",
  "id": 1234,
  "user_agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_13_3) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/70.0.3538.77 Safari/537.36 Vivaldi/2.1.1337.36\n",
  "last_authenticated": "2018-01-05T12:57:12",
  "last_remote_addr": "203.0.113.1"
}

Responses

200: The requested TrustedDevice object

created
string <date-time>

When this Remember Me session was started. This corresponds to the time of login with the "Remember Me" box checked.

expiry
string <date-time>

When this TrustedDevice session expires. Sessions typically last 30 days.

id
integer

The unique ID for this TrustedDevice

user_agent
string

The User Agent of the browser that created this TrustedDevice session.

last_authenticated
string <date-time>

The last time this TrustedDevice was successfully used to authenticate to login.linode.com.

last_remote_addr
string

The last IP Address to successfully authenticate with this TrustedDevice.

default: Error

errors
array of objects
reason
string

What happened to cause this error. In most cases, this can be fixed immediately by changing the data you sent in the request, but in some cases you will be instructed to open a Support Ticket or perform some other action before you can complete the request successfully.

field
string

The field in the request that caused this error. This may be a path, separated by periods in the case of nested fields. In some cases this may come back as "null" if the error is not specific to any single element of the request.

Trusted Device Revoke

delete
https://api.linode.com/v4/profile/devices/{deviceId}

Revoke an active TrustedDevice for your User. Once a TrustedDevice is revoked, this device will have to log in again before accessing your Linode account.

Path Parameters

deviceId
Required
integer

The ID of the TrustedDevice

Request Samples

curl -H "Content-Type: application/json" \
    -H "Authorization: Bearer $TOKEN" \
    -X DELETE \
    https://api.linode.com/v4/profile/devices/123

Response Samples

{}

Responses

200: Session revoked successfully

default: Error

errors
array of objects
reason
string

What happened to cause this error. In most cases, this can be fixed immediately by changing the data you sent in the request, but in some cases you will be instructed to open a Support Ticket or perform some other action before you can complete the request successfully.

field
string

The field in the request that caused this error. This may be a path, separated by periods in the case of nested fields. In some cases this may come back as "null" if the error is not specific to any single element of the request.