Profile

View Profile

get
https://api.linode.com/v4/profile

Returns information about the current User. This can be used to see who is acting in applications where more than one token is managed. For example, in third-party OAuth applications.

This endpoint is always accessible, no matter what OAuth scopes the acting token has.

Authorizations

Personal Access Token
OAuth: ( )

Request Samples

curl -H "Authorization: Bearer $TOKEN" \
    https://api.linode.com/v4/profile

Response Samples

{
  "email": "example-user@gmail.com",
  "username": "exampleUser",
  "restricted": "",
  "uid": 1234,
  "timezone": "US/Eastern",
  "email_notifications": true,
  "referrals": {
    "code": "871be32f49c1411b14f29f618aaf0c14637fb8d3",
    "url": "https://www.linode.com/?r=871be32f49c1411b14f29f618aaf0c14637fb8d3",
    "total": 0,
    "completed": 0,
    "pending": 0,
    "credit": 0
  },
  "ip_whitelist_enabled": "",
  "lish_auth_method": "keys_only",
  "authorized_keys": [],
  "two_factor_auth": true
}

Responses

200: Profile response.

email
string <email>

Your email address. This address will be used for communication with Linode as necessary.

username
string

Your username, used for logging in to our system.

restricted
boolean

If true, your User has restrictions on what can be accessed on your Account. To get details on what entities/actions you can access/perform, see /profile/grants.

uid
integer

Your unique ID in our system. This value will never change, and can safely be used to identify your User.

timezone
string

The timezone you prefer to see times in. This is not used by the API, and is for the benefit of clients only. All times the API returns are in UTC.

email_notifications
boolean

If true, you will receive email notifications about account activity. If false, you may still receive business-critical communications through email.

referrals
object

Information about your status in our referral program.

code
string

Your referral code. If others use this when signing up for Linode, you will receive account credit.

url
string

Your referral url, used to direct others to sign up for Linode with your referral code.

total
integer

The number of users who have signed up with your referral code.

completed
integer

The number of completed signups with your referral code.

pending
integer

The number of pending signups with your referral code. You will not receive credit for these signups until they are completed.

credit
integer

The amount of account credit in US Dollars issued to you through the referral program.

ip_whitelist_enabled
boolean
Deprecated

If true, logins for your User will only be allowed from whitelisted IPs. This setting is currently deprecated, and cannot be enabled.

If you disable this setting, you will not be able to re-enable it.

lish_auth_method
string
Enum: "password_keys""keys_only""disabled"

What methods of authentication are allowed when connecting via Lish. "keys_only" is the most secure if you intend to use Lish, and "disabled" is recommended if you do not intend to use Lish at all.

authorized_keys
Nullable
array of objects

The list of SSH Keys authorized to use Lish for your User. This value is ignored if lish_auth_method is "disabled."

two_factor_auth
boolean

If true, logins from untrusted computers will require Two Factor Authentication. See /profile/tfa-enable to enable Two Factor Authentication.

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.

Update Profile

put
https://api.linode.com/v4/profile

Update information in your Profile. This endpoint requires the "account:read_write" OAuth Scope.

Authorizations

Personal Access Token
OAuth: ( account:read_write)

Request Body Schema

authorized_keys
Nullable
array

The list of SSH Keys authorized to use Lish for your User. This value is ignored if lish_auth_method is "disabled."

email
string <email>

Your email address. This address will be used for communication with Linode as necessary.

email_notifications
boolean

If true, you will receive email notifications about account activity. If false, you may still receive business-critical communications through email.

ip_whitelist_enabled
boolean
Deprecated

If true, logins for your User will only be allowed from whitelisted IPs. This setting is currently deprecated, and cannot be enabled.

If you disable this setting, you will not be able to re-enable it.

lish_auth_method
string
Enum: "password_keys""keys_only""disabled"

What methods of authentication are allowed when connecting via Lish. "keys_only" is the most secure if you intend to use Lish, and "disabled" is recommended if you do not intend to use Lish at all.

restricted
boolean

If true, your User has restrictions on what can be accessed on your Account. To get details on what entities/actions you can access/perform, see /profile/grants.

timezone
string

The timezone you prefer to see times in. This is not used by the API, and is for the benefit of clients only. All times the API returns are in UTC.

two_factor_auth
boolean

If true, logins from untrusted computers will require Two Factor Authentication. See /profile/tfa-enable to enable Two Factor Authentication.

Request Samples

curl -H "Content-Type: application/json" \
    -H "Authorization: Bearer $TOKEN" \
    -X PUT -d '{
      "email": "example-user@gmail.com",
      "timezone": "US/Eastern",
      "email_notifications": true,
      "lish_auth_method": "keys_only",
      "authorized_keys": null,
      "two_factor_auth": true,
      "restricted": false
    }' \
    https://api.linode.com/v4/profile

Response Samples

{
  "email": "example-user@gmail.com",
  "username": "exampleUser",
  "restricted": "",
  "uid": 1234,
  "timezone": "US/Eastern",
  "email_notifications": true,
  "referrals": {
    "code": "871be32f49c1411b14f29f618aaf0c14637fb8d3",
    "url": "https://www.linode.com/?r=871be32f49c1411b14f29f618aaf0c14637fb8d3",
    "total": 0,
    "completed": 0,
    "pending": 0,
    "credit": 0
  },
  "ip_whitelist_enabled": "",
  "lish_auth_method": "keys_only",
  "authorized_keys": [],
  "two_factor_auth": true
}

Responses

200: Profile updated successfully.

email
string <email>

Your email address. This address will be used for communication with Linode as necessary.

username
string

Your username, used for logging in to our system.

restricted
boolean

If true, your User has restrictions on what can be accessed on your Account. To get details on what entities/actions you can access/perform, see /profile/grants.

uid
integer

Your unique ID in our system. This value will never change, and can safely be used to identify your User.

timezone
string

The timezone you prefer to see times in. This is not used by the API, and is for the benefit of clients only. All times the API returns are in UTC.

email_notifications
boolean

If true, you will receive email notifications about account activity. If false, you may still receive business-critical communications through email.

referrals
object

Information about your status in our referral program.

code
string

Your referral code. If others use this when signing up for Linode, you will receive account credit.

url
string

Your referral url, used to direct others to sign up for Linode with your referral code.

total
integer

The number of users who have signed up with your referral code.

completed
integer

The number of completed signups with your referral code.

pending
integer

The number of pending signups with your referral code. You will not receive credit for these signups until they are completed.

credit
integer

The amount of account credit in US Dollars issued to you through the referral program.

ip_whitelist_enabled
boolean
Deprecated

If true, logins for your User will only be allowed from whitelisted IPs. This setting is currently deprecated, and cannot be enabled.

If you disable this setting, you will not be able to re-enable it.

lish_auth_method
string
Enum: "password_keys""keys_only""disabled"

What methods of authentication are allowed when connecting via Lish. "keys_only" is the most secure if you intend to use Lish, and "disabled" is recommended if you do not intend to use Lish at all.

authorized_keys
Nullable
array of objects

The list of SSH Keys authorized to use Lish for your User. This value is ignored if lish_auth_method is "disabled."

two_factor_auth
boolean

If true, logins from untrusted computers will require Two Factor Authentication. See /profile/tfa-enable to enable Two Factor Authentication.

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.