Profile

Phone Number Verification Code Send

post
https://api.linode.com/v4/profile/phone-number

Send a one-time verification code via SMS message to the submitted phone number. Providing your phone number helps ensure you can securely access your Account in case other ways to connect are lost. Your phone number is only used to verify your identity by sending an SMS message. Standard carrier messaging fees may apply.

  • By accessing this command you are opting in to receive SMS messages. You can opt out of SMS messages by using the Phone Number Delete (DELETE /profile/phone-number) command after your phone number is verified.

  • Verification codes are valid for 10 minutes after they are sent.

  • Subsequent requests made prior to code expiration result in sending the same code.

Once a verification code is received, verify your phone number with the Phone Number Verify (POST /profile/phone-number/verify) command.

Request Body Schema

iso_code
Required
string

The two-letter ISO 3166 country code associated with the phone number.

phone_number
Required
string <phone>

A valid phone number.

Request Samples

curl -H "Content-Type: application/json" \
  -H "Authorization: Bearer $TOKEN" \
  -X POST -d '{
    "iso_code": "US",
    "phone_number": "555-555-5555"
  }' \
  https://api.linode.com/v4/profile/phone-number

Response Samples

{}

Responses

200: Phone number verification code request successful.

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.

Phone Number Delete

delete
https://api.linode.com/v4/profile/phone-number

Delete the verified phone number for the User making this request.

Use this command to opt out of SMS messages for the requesting User after a phone number has been verified with the Phone Number Verify (POST /profile/phone-number/verify) command.

Request Samples

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

Response Samples

{}

Responses

200: Phone number deletion request successful.

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.