Linode Instances

Linode Root Password Reset

post
https://api.linode.com/v4/linode/instances/{linodeId}/password

Resets the root password for this Linode.

  • Your Linode must be shut down for a password reset to complete.
  • If your Linode has more than one disk (not counting its swap disk), use the Reset Disk Root Password endpoint to update a specific disk's root password.
  • A password_reset event is generated when a root password reset is successful.

Path Parameters

linodeId
Required
integer

ID of the Linode for which to reset its root password.

Request Body Schema

root_pass
Required
string

The root user's password on this Linode. Linode passwords must meet a password strength score requirement that is calculated internally by the API. If the strength requirement is not met, you will receive a Password does not meet strength requirement error.

Request Samples

curl -H "Content-Type: application/json" \
  -H "Authorization: Bearer $TOKEN" \
    -X POST -d '{
      "root_pass": "a$eCure4assw0rd!43v51"
    }' \
    https://api.linode.com/v4/linode/instances/123/password

Response Samples

{}

Responses

200: Password Reset.

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.