Profile
Profile View
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.
Request Samples
- Shell
- CLI
curl -H "Authorization: Bearer $TOKEN" \
https://api.linode.com/v4/profile
Response Samples
- 200
- default
{
"email": "example-user@gmail.com",
"username": "exampleUser",
"restricted": "",
"verified_phone_number": "+5555555555",
"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,
"authentication_type": "password"
}
Responses
200: Profile response.
Your email address. This address will be used for communication with Linode as necessary.
Your username, used for logging in to our system.
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.
The phone number verified for this Profile with the Phone Number Verify (POST /profile/phone-number/verify) command.
null
if this Profile has no verified phone number.
Your unique ID in our system. This value will never change, and can safely be used to identify your User.
The timezone you prefer to see times in. This is not used by the API directly. It is provided for the benefit of clients such as the Linode Cloud Manager and other clients built on the API. All times returned by the API are in UTC.
If true, you will receive email notifications about account activity. If false, you may still receive business-critical communications through email.
Information about your status in our referral program.
This information becomes accessible after this Profile's Account has established at least $25.00 USD of total payments.
Your referral code. If others use this when signing up for Linode, you will receive account credit.
Your referral url, used to direct others to sign up for Linode with your referral code.
The number of users who have signed up with your referral code.
The number of completed signups with your referral code.
The number of pending signups with your referral code. You will not receive credit for these signups until they are completed.
The amount of account credit in US Dollars issued to you through the referral program.
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.
The authentication methods that are allowed when connecting to the Linode Shell (Lish).
keys_only
is the most secure if you intend to use Lish.disabled
is recommended if you do not intend to use Lish at all.- If this account's Cloud Manager authentication type is set to a Third-Party Authentication method,
password_keys
cannot be used as your Lish authentication method. To view this account's Cloud Managerauthentication_type
field, send a request to the View Profile endpoint.
The list of SSH Keys authorized to use Lish for your User. This value is ignored if lish_auth_method
is "disabled."
If true, logins from untrusted computers will require Two Factor Authentication. See /profile/tfa-enable to enable Two Factor Authentication.
This account's Cloud Manager authentication type. Authentication types are chosen through Cloud Manager and authorized when logging into your account. These authentication types are either the user's password (in conjunction with their username), or the name of their indentity provider such as GitHub. For example, if a user:
- Has never used Third-Party Authentication, their authentication type will be
password
. - Is using Third-Party Authentication, their authentication type will be the name of their Identity Provider (eg.
github
). - Has used Third-Party Authentication and has since revoked it, their authentication type will be
password
.
Note: This functionality may not yet be available in Cloud Manager. See the Cloud Manager Changelog for the latest updates.
default: Error
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.
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.
Profile Update
https://api.linode.com/v4/profile
Update information in your Profile. This endpoint requires the "account:read_write" OAuth Scope.
Request Body Schema
The list of SSH Keys authorized to use Lish for your User. This value is ignored if lish_auth_method
is "disabled."
Your email address. This address will be used for communication with Linode as necessary.
If true, you will receive email notifications about account activity. If false, you may still receive business-critical communications through email.
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.
The authentication methods that are allowed when connecting to the Linode Shell (Lish).
keys_only
is the most secure if you intend to use Lish.disabled
is recommended if you do not intend to use Lish at all.- If this account's Cloud Manager authentication type is set to a Third-Party Authentication method,
password_keys
cannot be used as your Lish authentication method. To view this account's Cloud Managerauthentication_type
field, send a request to the View Profile endpoint.
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.
The timezone you prefer to see times in. This is not used by the API directly. It is provided for the benefit of clients such as the Linode Cloud Manager and other clients built on the API. All times returned by the API are in UTC.
If true, logins from untrusted computers will require Two Factor Authentication. See /profile/tfa-enable to enable Two Factor Authentication.
Request Samples
- Shell
- CLI
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
- 200
- default
{
"email": "example-user@gmail.com",
"username": "exampleUser",
"restricted": "",
"verified_phone_number": "+5555555555",
"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,
"authentication_type": "password"
}
Responses
200: Profile updated successfully.
Your email address. This address will be used for communication with Linode as necessary.
Your username, used for logging in to our system.
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.
The phone number verified for this Profile with the Phone Number Verify (POST /profile/phone-number/verify) command.
null
if this Profile has no verified phone number.
Your unique ID in our system. This value will never change, and can safely be used to identify your User.
The timezone you prefer to see times in. This is not used by the API directly. It is provided for the benefit of clients such as the Linode Cloud Manager and other clients built on the API. All times returned by the API are in UTC.
If true, you will receive email notifications about account activity. If false, you may still receive business-critical communications through email.
Information about your status in our referral program.
This information becomes accessible after this Profile's Account has established at least $25.00 USD of total payments.
Your referral code. If others use this when signing up for Linode, you will receive account credit.
Your referral url, used to direct others to sign up for Linode with your referral code.
The number of users who have signed up with your referral code.
The number of completed signups with your referral code.
The number of pending signups with your referral code. You will not receive credit for these signups until they are completed.
The amount of account credit in US Dollars issued to you through the referral program.
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.
The authentication methods that are allowed when connecting to the Linode Shell (Lish).
keys_only
is the most secure if you intend to use Lish.disabled
is recommended if you do not intend to use Lish at all.- If this account's Cloud Manager authentication type is set to a Third-Party Authentication method,
password_keys
cannot be used as your Lish authentication method. To view this account's Cloud Managerauthentication_type
field, send a request to the View Profile endpoint.
The list of SSH Keys authorized to use Lish for your User. This value is ignored if lish_auth_method
is "disabled."
If true, logins from untrusted computers will require Two Factor Authentication. See /profile/tfa-enable to enable Two Factor Authentication.
This account's Cloud Manager authentication type. Authentication types are chosen through Cloud Manager and authorized when logging into your account. These authentication types are either the user's password (in conjunction with their username), or the name of their indentity provider such as GitHub. For example, if a user:
- Has never used Third-Party Authentication, their authentication type will be
password
. - Is using Third-Party Authentication, their authentication type will be the name of their Identity Provider (eg.
github
). - Has used Third-Party Authentication and has since revoked it, their authentication type will be
password
.
Note: This functionality may not yet be available in Cloud Manager. See the Cloud Manager Changelog for the latest updates.
default: Error
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.
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.