# Passwords and email addresses

Questions about a forgotten password, changing a password, moving an account
to a new email address and the name on the account. The rules are in [Password
and email address](../accounts/password-and-email.md).

## Forgotten password

### I forgot my password. How do I reset it?

On the sign-in page choose "Forgot password?". Enter your email address and
choose "Send reset link". Open the link in the email "Reset your Talewright
password" and set a new password. The form is at
`https://app.usetalewright.com/forgot-password`.

More: [Password and email address, Forgot password](../accounts/password-and-email.md#forgot-password)

### How long is a password reset link valid?

1 hour. It works once, and only the newest link works.

More: [Password and email address, Limits](../accounts/password-and-email.md#limits)

### Why didn't I get the password reset email?

The page shows "Check your email" whether or not the address has an account,
and nothing is sent to an address without one. Check that you entered the
address of your account. Only the newest email's link works.

More: [Password and email address, Forgotten password: asking for a link](../accounts/password-and-email.md#forgotten-password-asking-for-a-link)

### Does asking for a reset link change my password or sign me out?

No. Asking changes nothing. The current password keeps working and every
session stays, until a new password is actually set.

More: [Password and email address, Forgotten password: asking for a link](../accounts/password-and-email.md#forgotten-password-asking-for-a-link)

### I got a password reset email that I did not ask for. What should I do?

Nothing. Someone entered your address. If you ignore the email, nothing
changes, and the link expires after 1 hour.

More: [Password and email address, Edge cases](../accounts/password-and-email.md#edge-cases)

### How many password reset emails can be requested?

10 for one email address and 100 from one client address, in 15 minutes.

More: [Password and email address, Limits](../accounts/password-and-email.md#limits)

### Does "Check your email" on the forgot-password page mean the address has an account?

No. The answer is always the same and never says whether the address has an
account. The text reads "If {address} belongs to an account, we sent it a link
to set a new password."

More: [Password and email address, Forgotten password: asking for a link](../accounts/password-and-email.md#forgotten-password-asking-for-a-link)

### I asked for two reset emails. Which link works?

Only the link in the newest email. Asking again makes the earlier link
invalid.

More: [Password and email address, Forgotten password: asking for a link](../accounts/password-and-email.md#forgotten-password-asking-for-a-link)

### Can I open the reset link on a different device than the one I asked from?

Yes. The link works in any browser, on any device.

More: [Password and email address, Forgotten password: setting the new password](../accounts/password-and-email.md#forgotten-password-setting-the-new-password)

### Do I need to be signed in to reset my password?

No. The reset link needs no session. Whoever holds the link can set the new
password.

More: [Password and email address, Forgotten password: setting the new password](../accounts/password-and-email.md#forgotten-password-setting-the-new-password)

### Can I reset my password when my email is not verified?

Yes. The reset email is sent to an unverified account too. Using it sets the
password and verifies the email, because the link reached the inbox.

More: [Password and email address, Edge cases](../accounts/password-and-email.md#edge-cases)

### What happens when I set a new password from a reset link?

All of this:

- the password is replaced;
- an unverified email becomes verified;
- every session ends, including the one in the browser that sets the password;
- every other emailed link of the account becomes invalid;
- a pending email change is cancelled;
- every API key and connected app of yours is revoked;
- the count of failed sign-in attempts for the email address from all client
  addresses is cleared, and so is the sign-in count for it from the client
  address that set the password;
- the email "Your Talewright password was changed" goes to the account's
  address.

More: [Password and email address, Forgotten password: setting the new password](../accounts/password-and-email.md#forgotten-password-setting-the-new-password)

### Am I signed in after I reset my password?

No. Every session ends, including one in the browser that set the password.
The sign-in page opens with "Password updated" and "Sign in with your new
password."

More: [Password and email address, Setting the new password](../accounts/password-and-email.md#setting-the-new-password)

### Can I reset my password to the one I already had?

Yes. A password set from a reset link is not compared with the old one.
Everything else still happens: sessions end and credentials are revoked.

More: [Password and email address, Edge cases](../accounts/password-and-email.md#edge-cases)

### What does "Link expired or invalid" mean on the reset page?

The reset link is unknown, more than 1 hour old, already used or replaced by a
newer one. The page says "Reset links work once and expire after 1 hour.
Request a new one to set your password." Choose "Request a new link".

More: [Password and email address, Setting the new password](../accounts/password-and-email.md#setting-the-new-password)

### Why does the reset page show the password form although my link is dead?

A dead link is found when "Set password" is pressed, not when the page opens.
"Link expired or invalid" appears after that.

More: [Password and email address, Setting the new password](../accounts/password-and-email.md#setting-the-new-password)

### I typed a too-short password on the reset page. Do I need a new link?

No. A too-short or too-long password is refused under "New password" and does
not use the link up.

More: [Password and email address, Forgotten password: setting the new password](../accounts/password-and-email.md#forgotten-password-setting-the-new-password)

### What does "Password updated" mean on the sign-in page?

A new password was set from a reset link. Sign in with the new password.

More: [Password and email address, Setting the new password](../accounts/password-and-email.md#setting-the-new-password)

### What is in the email "Reset your Talewright password"?

A button "Reset password" and the line "For security, this link expires in 1
hour." It goes to the account's address when a reset is requested for an
address with an account.

More: [Password and email address, Forgotten password: asking for a link](../accounts/password-and-email.md#forgotten-password-asking-for-a-link)

### I forgot my password and can no longer open my mailbox. Can I get back into my account?

No. A forgotten password is replaced only from a link emailed to the account's
address, and changing the email address needs the current password. A browser
that is still signed in keeps working until its session ends.

More: [Password and email address, Forgotten password: asking for a link](../accounts/password-and-email.md#forgotten-password-asking-for-a-link)

### How many attempts to set a password from a reset link are allowed?

100 per client address in 15 minutes.

More: [Password and email address, Limits](../accounts/password-and-email.md#limits)

### What happens when I use a reset link in a browser that is signed in to a different account?

The account the link belongs to gets the new password. The signed-in account
is untouched, and the app opens its start page with the message "Password
updated".

More: [Password and email address, Edge cases](../accounts/password-and-email.md#edge-cases)

### Can I use a reset link a second time?

No. It is dead. The password set the first time stays.

More: [Password and email address, Edge cases](../accounts/password-and-email.md#edge-cases)

### Why does the "Forgot password?" page say "Enter a valid email address."?

The address is empty, longer than 320 characters or holds a control character.
Correct it and choose "Send reset link" again.

More: [Password and email address, Forgot password](../accounts/password-and-email.md#forgot-password)

### What happens if I double-click "Send reset link"?

One email is sent. The form sends one request at a time.

More: [Password and email address, Forgotten password: asking for a link](../accounts/password-and-email.md#forgotten-password-asking-for-a-link)

## Changing your password

### How do I change my password?

Open Settings, then "Security". In the section "Password" enter "Current
password" and "New password" and choose "Change password". The page is at
`https://app.usetalewright.com/settings/security`.

More: [Password and email address, Changing the password](../accounts/password-and-email.md#changing-the-password)

### Do I need my current password to change my password?

Yes. If you no longer know it, use "Forgot password?" on the sign-in page to
set a new one from an emailed link.

More: [Password and email address, Changing the password while signed in](../accounts/password-and-email.md#changing-the-password-while-signed-in)

### Can my new password be the same as my current one?

No. When you change the password while signed in, the new one must differ from
the current one: "Choose a password different from your current one."

More: [Password and email address, Changing the password while signed in](../accounts/password-and-email.md#changing-the-password-while-signed-in)

### Can I go back to a password I used earlier?

Yes. The new password is compared only with the current one.

More: [Password and email address, Changing the password while signed in](../accounts/password-and-email.md#changing-the-password-while-signed-in)

### Does changing my password sign me out?

Not in the browser that made the change. Every other browser, such as the one
on your phone, is signed out at its next request.

More: [Password and email address, Changing the password while signed in](../accounts/password-and-email.md#changing-the-password-while-signed-in)

### What does changing my password do to the rest of my account?

It ends all other sessions, makes every emailed link of the account invalid,
revokes every API key and connected app, and cancels a pending email change.
Whether the email is verified does not change.

More: [Password and email address, What each change does](../accounts/password-and-email.md#what-each-change-does)

### Do I get an email when my password changes?

Yes. "Your Talewright password was changed" goes to the account's address when
a password is set from a reset link or changed while signed in.

More: [Password and email address, Emails this feature sends](../accounts/password-and-email.md#emails-this-feature-sends)

### I got "Your Talewright password was changed" and it was not me. What do I do?

Use the "Reset password" button in that email at once. Setting a new password
ends every session and revokes every API key and connected app.

More: [Password and email address, Emails this feature sends](../accounts/password-and-email.md#emails-this-feature-sends)

### Can I turn off the email about a changed password?

No. The email ends with "This security notice was sent to {address} and cannot
be turned off."

More: [Password and email address, Emails this feature sends](../accounts/password-and-email.md#emails-this-feature-sends)

### Why do I get "Your current password is incorrect."?

The current password you typed is wrong. You stay signed in, and the attempt
counts toward the limit on wrong current passwords.

More: [Password and email address, Changing the password](../accounts/password-and-email.md#changing-the-password)

### Does changing my password verify my email?

No. The account stays unverified. A reset from an emailed link does verify it.

More: [Password and email address, Changing the password while signed in](../accounts/password-and-email.md#changing-the-password-while-signed-in)

### Does my password expire?

No. A password stays valid until you change or reset it.

More: [Password and email address, Changing the password while signed in](../accounts/password-and-email.md#changing-the-password-while-signed-in)

### What does "Password changed. Your other sessions were signed out and your API keys and connected apps revoked." mean?

The change went through. This browser stays signed in, every other session
ended and every API key and connected app of yours was revoked.

More: [Password and email address, Changing the password](../accounts/password-and-email.md#changing-the-password)

### Why did my API keys and connected apps stop working after I changed my password?

Every password change or reset revokes them all, in every organization.
Someone who had your password or a session could have created them.

More: [Password and email address, What each change does](../accounts/password-and-email.md#what-each-change-does)

### Can I get API keys back that a password change revoked?

No. They stop working at once and cannot be revived. Create new keys and
connect the apps again.

More: [Password and email address, What each change does](../accounts/password-and-email.md#what-each-change-does)

### My current password is wrong and my new one is too short. Which problem is shown?

The new password. Checks happen in this order: the new password's length, then
the current password, then that the two differ. That attempt is not counted.

More: [Password and email address, Changing the password while signed in](../accounts/password-and-email.md#changing-the-password-while-signed-in)

### Can I change my password before verifying my email?

Yes. A verified and an unverified account can do the same things with
passwords, email addresses and names.

More: [Password and email address, Who can do what](../accounts/password-and-email.md#who-can-do-what)

### Is a password-changed email sent when I choose a password from a verification link?

No. That email is sent when a password is set from a reset link or changed
while signed in.

More: [Password and email address, Emails this feature sends](../accounts/password-and-email.md#emails-this-feature-sends)

## Wrong current passwords

### How many times can I enter a wrong current password?

10 checks per account in 15 minutes. Further attempts are refused, even with
the correct password, until the 15 minutes end.

More: [Password and email address, Limit on wrong current passwords](../accounts/password-and-email.md#limit-on-wrong-current-passwords)

### Which actions share the limit on wrong current passwords?

Three: changing the password, starting an email change and deleting the
account. They share one count per account.

More: [Password and email address, Limit on wrong current passwords](../accounts/password-and-email.md#limit-on-wrong-current-passwords)

### Does the limit on wrong current passwords follow me to another browser or network?

Yes. The count belongs to the account, not to the browser or the network.

More: [Password and email address, Limit on wrong current passwords](../accounts/password-and-email.md#limit-on-wrong-current-passwords)

### Does entering the correct current password clear the count?

Yes. A correct password clears it.

More: [Password and email address, Limit on wrong current passwords](../accounts/password-and-email.md#limit-on-wrong-current-passwords)

### What does "Too many attempts. Try again in 4 minutes." mean in Security settings?

The limit on wrong current passwords, or on email change requests, was
reached. Wait for the time shown, which varies.

More: [Password and email address, Changing the email address](../accounts/password-and-email.md#changing-the-email-address-1)

## Changing your email address

### How do I change my email address?

Open Settings, then "Security". In the section "Email" enter "New email" and
"Current password" and choose "Change email". Then open the link sent to the
new address. Until then nothing changes.

More: [Password and email address, Changing the email address](../accounts/password-and-email.md#changing-the-email-address-1)

### Do I need my password to change my email address?

Yes. Starting an email change takes the new address and the current password.
Cancelling a pending change needs no password.

More: [Password and email address, Changing the email address](../accounts/password-and-email.md#changing-the-email-address)

### When does my new email address take effect?

When the confirmation link sent to the new address is opened. Until then the
account keeps its current address and you keep signing in with it.

More: [Password and email address, Changing the email address](../accounts/password-and-email.md#changing-the-email-address)

### How long is the email confirmation link valid?

24 hours. It works once, and a new request replaces it.

More: [Password and email address, Limits](../accounts/password-and-email.md#limits)

### Why didn't I get the confirmation email at my new address?

Check the address shown in settings. If it has a typing mistake, choose
"Cancel change" and start again. If the address already belongs to another
Talewright account, no confirmation is sent.

More: [Password and email address, When the new address belongs to another account](../accounts/password-and-email.md#when-the-new-address-belongs-to-another-account)

### I made a typing mistake in my new email address. What should I do?

Choose "Cancel change" at once, or start the change again with the right
address, which makes the mistyped link invalid. This matters because whoever
opens a confirmation link confirms the change, signed in or not.

More: [Password and email address, Edge cases](../accounts/password-and-email.md#edge-cases)

### How do I cancel an email change?

Choose "Cancel change" in the section "Email" while the change is pending. The
app shows "Email change cancelled" and the confirmation link stops working at
once.

More: [Password and email address, Cancelling a pending change](../accounts/password-and-email.md#cancelling-a-pending-change)

### Can I undo an email change after it was confirmed?

Not directly. Start a new change back to the old address, which works as long
as nobody has created an account with it.

More: [Password and email address, Confirming the new address](../accounts/password-and-email.md#confirming-the-new-address)

### Do I have to be signed in to confirm my new email address?

No. The link works in any browser, on any device, signed in or not.

More: [Password and email address, Confirming the new address](../accounts/password-and-email.md#confirming-the-new-address)

### Can someone else confirm my email change?

Yes, anyone who holds the link. Whoever opens it confirms the change. That is
why a mistyped address should be cancelled at once.

More: [Password and email address, Confirming the new address](../accounts/password-and-email.md#confirming-the-new-address)

### Does changing my email sign me out or revoke my API keys?

No. Confirming keeps every session, API key and connected app.

More: [Password and email address, Confirming the new address](../accounts/password-and-email.md#confirming-the-new-address)

### Does changing my email address change my password?

No. Confirming keeps the password.

More: [Password and email address, Confirming the new address](../accounts/password-and-email.md#confirming-the-new-address)

### What happens to my old email address after the change?

It no longer signs in. It is free: anyone can create a new, separate account
with it.

More: [Password and email address, Confirming the new address](../accounts/password-and-email.md#confirming-the-new-address)

### Is my old address told about an email change?

Yes, when the change is requested. "Your Talewright email is being changed"
goes to the current address and names the new one. No email is sent at
confirmation.

More: [Password and email address, Confirming the new address](../accounts/password-and-email.md#confirming-the-new-address)

### I got "Your Talewright email is being changed" and it was not me. What do I do?

Use the "Reset password" button in that email. Someone signed in to your
account asked for the change. A reset cancels the pending change, ends every
session and revokes every credential.

More: [Password and email address, Edge cases](../accounts/password-and-email.md#edge-cases)

### What does the email "Someone tried to use your email on Talewright" mean?

Someone tried to move another Talewright account to your address. It already
belongs to your account, so nothing changed. You do not need to do anything.

More: [Password and email address, Emails this feature sends](../accounts/password-and-email.md#emails-this-feature-sends)

### Can I change my email to an address that another account uses?

No. The request looks as usual and shows the change as pending, but no
confirmation link is sent, so it can never be confirmed. The request does not
reveal that the address is taken. The holder of the address is told that
nothing changed.

More: [Password and email address, When the new address belongs to another account](../accounts/password-and-email.md#when-the-new-address-belongs-to-another-account)

### What does "This is already your email address." mean?

The new address equals your current one. Upper and lower case do not count as
a difference.

More: [Password and email address, Changing the email address](../accounts/password-and-email.md#changing-the-email-address-1)

### What does "Check {new address} for a confirmation link. Your email stays {current address} until you open it." mean?

An email change is pending. It stays shown after a reload, for as long as the
change is pending, with the button "Cancel change".

More: [Password and email address, Changing the email address](../accounts/password-and-email.md#changing-the-email-address-1)

### How long does a pending email change stay pending?

Until it is confirmed, cancelled, replaced by a new request or 24 hours old,
or until the password is changed or reset.

More: [Password and email address, Changing the email address](../accounts/password-and-email.md#changing-the-email-address)

### Can I have two email changes pending at once?

No. An account has one pending change. A new request replaces it, and the
earlier confirmation link becomes invalid. The current address gets a notice
for each request.

More: [Password and email address, Changing the email address](../accounts/password-and-email.md#changing-the-email-address)

### What does "Email confirmed" mean?

The account has moved to the new address. The page says "Email updated. Use
the new address the next time you sign in."

More: [Password and email address, Confirming the new address](../accounts/password-and-email.md#confirming-the-new-address-1)

### What does "Email not changed" mean?

Another account took the address between your request and the confirmation.
Your email stays as it was. Start a new change from "Open security settings".

More: [Password and email address, Confirming the new address](../accounts/password-and-email.md#confirming-the-new-address-1)

### What does "Link expired or invalid" mean when I confirm a new email?

The confirmation link is unknown, more than 24 hours old, already used,
replaced or cancelled. Start the change again from your account settings.

More: [Password and email address, Confirming the new address](../accounts/password-and-email.md#confirming-the-new-address-1)

### What does "Could not confirm your email" mean?

The confirmation did not go through. The page shows "Too many attempts. Try
again in 4 minutes." (the time varies) or "Something went wrong. Try again.",
with the button "Try again".

More: [Password and email address, Confirming the new address](../accounts/password-and-email.md#confirming-the-new-address-1)

### How many attempts to confirm an email change are allowed?

100 per client address in 15 minutes.

More: [Password and email address, Limits](../accounts/password-and-email.md#limits)

### What happens if I open the confirmation link twice?

The second time shows "Link expired or invalid". The change stays confirmed.

More: [Password and email address, Edge cases](../accounts/password-and-email.md#edge-cases)

### Does confirming a new email address verify my account?

Yes. The new address is marked as verified. A verification link sent earlier
to the old address becomes invalid.

More: [Password and email address, Confirming the new address](../accounts/password-and-email.md#confirming-the-new-address)

### I was invited at my old address. Can I still accept after changing my email?

No. An invitation is for the address it was sent to. Ask for a new invitation
to your new address.

More: [Password and email address, Edge cases](../accounts/password-and-email.md#edge-cases)

### How many email changes can I request?

10 per account in 15 minutes. Further requests are refused and send no email.

More: [Password and email address, Limits](../accounts/password-and-email.md#limits)

### Why did my pending email change disappear after I changed or reset my password?

A new password, set from a reset link or changed while signed in, cancels a
pending email change. Start the change again.

More: [Password and email address, Edge cases](../accounts/password-and-email.md#edge-cases)

### What happens if the confirmation link is opened in a browser signed in to a different account?

The account the link belongs to is changed. The signed-in account is not.

More: [Password and email address, Edge cases](../accounts/password-and-email.md#edge-cases)

### Do my other signed-in devices show the new address after I confirm?

Yes. Every session stays signed in and shows the new address at its next load.

More: [Password and email address, Edge cases](../accounts/password-and-email.md#edge-cases)

### Can I add a second email address to my account?

No. An account has one email address. A change replaces it once the new
address is confirmed.

More: [Password and email address, Changing the email address](../accounts/password-and-email.md#changing-the-email-address)

### I can no longer open my old mailbox. Can I still change my email address?

Yes. You need to be signed in, your current password and access to the new
address. The confirmation link goes to the new address. The old address only
gets a notice.

More: [Password and email address, Changing the email address](../accounts/password-and-email.md#changing-the-email-address)

### Which emails are sent when I ask for an email change?

Two, when the new address is free. "Confirm your new email for Talewright"
goes to the new address, with the button "Confirm new email". "Your Talewright
email is being changed" goes to the current address and names the new one.

More: [Password and email address, Changing the email address](../accounts/password-and-email.md#changing-the-email-address)

### Where does "Continue to Talewright" lead after I confirm my new email?

To the app. In a browser that is not signed in, it leads to sign-in, where you
use the new address.

More: [Password and email address, Edge cases](../accounts/password-and-email.md#edge-cases)

## Your name

### How do I change my name?

Open Settings, then "Account". In the section "Profile" change "Full name" and
choose "Save". The app shows "Profile updated" and the account menu shows the
new name.

More: [Password and email address, Changing the name](../accounts/password-and-email.md#changing-the-name)

### Can I change my username?

No. Accounts have no username. You sign in with your email address, and the
name others see is your full name, which you change under Settings, "Account".

More: [Password and email address, The name](../accounts/password-and-email.md#the-name)

### Why is the "Save" button disabled on the Account page?

The name has not changed. "Save" stays disabled until the name differs, and
spaces at its ends do not count as a difference.

More: [Password and email address, Changing the name](../accounts/password-and-email.md#changing-the-name)

### Where does my name appear?

On file versions and to the people in your organizations. Emails from
Talewright greet you by it: "Hi {full name},".

More: [Password and email address, The name](../accounts/password-and-email.md#the-name)

### Does changing my name update files I uploaded earlier?

Yes. A changed name shows everywhere the old one did, including on versions
uploaded earlier.

More: [Password and email address, The name](../accounts/password-and-email.md#the-name)

### Do I need my password to change my name?

No.

More: [Password and email address, The name](../accounts/password-and-email.md#the-name)

### Can I add a profile photo?

No. The section "Profile" holds one field, "Full name".

More: [Password and email address, Changing the name](../accounts/password-and-email.md#changing-the-name)

### Does changing my name sign me out or revoke anything?

No. A name change ends no session, revokes no API key or connected app and
leaves emailed links as they are.

More: [Password and email address, What each change does](../accounts/password-and-email.md#what-each-change-does)

### Can an owner or admin change my password, email address or name?

No. Nobody can change another person's password, email address or name. No
role grants that.

More: [Password and email address, Who can do what](../accounts/password-and-email.md#who-can-do-what)

## Finding the settings

### Where are my account settings?

Open the account menu at the bottom of the navigation and choose "Settings",
or choose "Open settings" in the command palette. Settings opens on "Account".

More: [Password and email address, Where the account's settings are](../accounts/password-and-email.md#where-the-accounts-settings-are)

### What is on the Security settings page?

The password and the email address. "Sessions" and "Delete account" are pages
under "Security": they show in the navigation while you are on one of the
three pages, and from any other page through the arrow "Show Security
sub-items".

More: [Password and email address, Where the account's settings are](../accounts/password-and-email.md#where-the-accounts-settings-are)

### How do I open the settings navigation on a narrow screen?

Use the button that shows the current page's title. The navigation opens from
it.

More: [Password and email address, Where the account's settings are](../accounts/password-and-email.md#where-the-accounts-settings-are)

## What each change does

### What is the difference between resetting my password and changing it?

A reset uses an emailed link, needs no session, ends every session and
verifies the email. A change needs the current password and keeps the current
browser signed in. Both revoke every API key and connected app.

More: [Password and email address, What each change does](../accounts/password-and-email.md#what-each-change-does)

### Which account changes revoke my API keys and connected apps?

A new password, however it is set: from a reset link, changed while signed in,
or chosen from a verification link in another browser. An email change or a
name change revokes none.

More: [Password and email address, What each change does](../accounts/password-and-email.md#what-each-change-does)

### Which emailed links stop working when I set a new password?

The account's verification link, its password reset link and its email change
confirmation link. Invitation links are separate and are not affected.

More: [Password and email address, What each change does](../accounts/password-and-email.md#what-each-change-does)

### Does a confirmed email change make my other emailed links invalid?

Yes. Confirming makes every other emailed link of the account invalid.
Cancelling a change makes only the confirmation link invalid.

More: [Password and email address, What each change does](../accounts/password-and-email.md#what-each-change-does)

### Does changing my password or email affect invitations sent to me?

A new password does not: invitation links are separate from the account's
emailed links. A confirmed email change does: an invitation sent to the old
address can no longer be accepted by the account, because an invitation is for
the address it was sent to.

More: [Password and email address, What each change does](../accounts/password-and-email.md#what-each-change-does)

## For developers and agents

### Can an agent or an API key change my password, email address or name?

No. These operations refuse API keys and connected apps with `403 FORBIDDEN`,
reason `SESSION_REQUIRED`, and none is an MCP tool.

More: [Password and email address, For agents](../accounts/password-and-email.md#for-agents)

### What happens to an agent when the member it acts for changes or resets their password?

Its API key or connected app is revoked. Its next request answers `401
UNAUTHENTICATED`, reason `INVALID_TOKEN`. A connected app's refresh is refused
too. Only the member can issue a new credential, in a browser.

More: [Password and email address, For agents](../accounts/password-and-email.md#for-agents)

### How do I request a password reset through the API?

Send `POST /v1/auth/password-reset` with `email`. It answers `202` whenever
the address is well formed, with no body.

More: [Password and email address, For agents](../accounts/password-and-email.md#for-agents)

### How do I set a new password through the API with a reset token?

Send `POST /v1/auth/password-reset/confirm` with `token`, the `token` query
parameter of the emailed link, and `newPassword`. `204` means the password is
set. No cookie is set.

More: [Password and email address, For agents](../accounts/password-and-email.md#for-agents)

### How do I change my password through the API?

Send `POST /v1/me/password` with `currentPassword` and `newPassword`, using a
browser session. `204` means changed.

More: [Password and email address, For agents](../accounts/password-and-email.md#for-agents)

### How do I change my email address through the API?

Send `POST /v1/me/email` with `newEmail` and `currentPassword`. `202` means
accepted. Then send `POST /v1/auth/email-change/confirm` with the `token` from
the email sent to the new address. `204` means the account has the new
address.

More: [Password and email address, For agents](../accounts/password-and-email.md#for-agents)

### How do I see a pending email change through the API?

Read `pendingEmail` in `GET /v1/me`. It is the new address, or `null` when
nothing is pending.

More: [Password and email address, For agents](../accounts/password-and-email.md#for-agents)

### What does `DELETE /v1/me/email` answer when no change is pending?

`204`. Cancelling when nothing is pending is not an error.

More: [Password and email address, For agents](../accounts/password-and-email.md#for-agents)

### What does `409 CONFLICT` "another account uses this email address" mean?

Another account took the address between the request and the confirmation. The
account keeps its email and the link is not used up. Start a change to another
address.

More: [Password and email address, Confirming the new address](../accounts/password-and-email.md#confirming-the-new-address)

### How do I change the name through the API?

Send `PATCH /v1/me` with `fullName`. It answers `200` with the user: `id`,
`email` and `fullName`.

More: [Password and email address, For agents](../accounts/password-and-email.md#for-agents)

### Why does the API report a too-short password before a dead reset link?

The fields are checked before the link. A too-short `newPassword` with a dead
link answers `422`, not `400 TOKEN_INVALID`.

More: [Password and email address, Edge cases](../accounts/password-and-email.md#edge-cases)

### What does "currentPassword must be 1 to 1024 bytes" mean?

The `currentPassword` sent was empty or larger than 1024 bytes.

More: [Password and email address, Errors](../accounts/password-and-email.md#errors)

### What happens to a reset or email change request when Talewright cannot send email?

The request answers `503 UNAVAILABLE` with reason `EMAIL_UNAVAILABLE`, and the
change it belongs to does not happen. Try again later.

More: [Password and email address, Edge cases](../accounts/password-and-email.md#edge-cases)

### In what order is an email change request checked?

The new address's shape, then the current password, then the limit on
requests, then that the address differs from the current one.

More: [Password and email address, Changing the email address](../accounts/password-and-email.md#changing-the-email-address)

### Does an email change request with a wrong password count toward the limit of 10 requests?

No. It counts toward the limit on wrong current passwords instead.

More: [Password and email address, Changing the email address](../accounts/password-and-email.md#changing-the-email-address)

### Which `VALIDATION_FAILED` messages can a new password get?

"newPassword must be 12 to 128 characters", or "newPassword must differ from
the current password" when changing it while signed in.

More: [Password and email address, Errors](../accounts/password-and-email.md#errors)

### Which `VALIDATION_FAILED` messages can a new email address get?

"newEmail must be an email address of at most 320 characters", or "newEmail is
already the account's email".

More: [Password and email address, Errors](../accounts/password-and-email.md#errors)

### What does `TOKEN_INVALID` mean for a reset or confirmation link?

`400 TOKEN_INVALID`, "This link is invalid or has expired": the link is
unknown, expired, used, replaced or cancelled. Request a new reset link, or
start the email change again.

More: [Password and email address, Errors](../accounts/password-and-email.md#errors)

### Which password and email operations work without a session?

Three are public: requesting a reset, setting a password from a reset link and
confirming an email change. Changing the password, starting or cancelling an
email change and changing the name need a browser session.

More: [Password and email address, For agents](../accounts/password-and-email.md#for-agents)
