Profile

Security Questions List

get
https://api.linode.com/v4/profile/security-questions

Returns a collection of security questions and their responses, if any, for your User Profile.

Request Samples

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

Response Samples

{
  "security_questions": [
    {
      "id": 1,
      "question": "In what city were you born?",
      "response": "Gotham City"
    }
  ]
}

Responses

200: Returns a list of security questions.

security_questions
array of objects
id
integer

The ID representing the security question.

question
string

The security question.

response
string

The security question response.

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.

Security Questions Answer

post
https://api.linode.com/v4/profile/security-questions

Adds security question responses for your User.

Requires exactly three unique questions.

Previous responses are overwritten if answered or reset to null if unanswered.

Note: Security questions must be answered for your User prior to accessing the Two Factor Secret Create (POST /profile/tfa-enable) command.

Request Body Schema

security_questions
array

Request Samples

curl -H "Content-Type: application/json" \
    -H "Authorization: Bearer $TOKEN" \
    -X POST -d '{
        "security_questions": [
            {
                "question_id": 1,
                "response": "secret answer 1"
            },
            {
                "question_id": 2,
                "response": "secret answer 2"
            },
            {
                "question_id": 11,
                "response": "secret answer 3"
            }
        ]
    }' \
    https://api.linode.com/v4/profile/security-questions

Response Samples

{
  "security_questions": [
    {
      "question_id": 1,
      "response": "Gotham City",
      "security_question": "In what city were you born?"
    }
  ]
}

Responses

200: Security Questions answered successfully.

security_questions
array of objects
question_id
integer

The ID representing the security question.

response
string

The security question response.

security_question
string

The security question.

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.