On this page
Operator manual

app:user:rename

Change a user's display name. The command runs the same use case as changing the name in the admin panel's user editor (PATCH /api/admin/users/{publicId} in the admin API). That editor also changes the email address; for that, use app:user:change-email.

Quick start

make exec cmd="php bin/console app:user:rename alice@baander.app 'Alice Jensen'"

Arguments

Argument Required Description
identifier Yes The user's email address or public ID
name Yes The new display name

Options

Option Description
--json Print only the changed user, as the admin API's data payload, in JSON

Details

The name is stored as given, including any leading or trailing spaces. A name that is empty or only whitespace is rejected with Name cannot be empty., and one longer than 255 characters with Name cannot be longer than 255 characters. The admin API rejects the same names with the same messages.

Renaming a user to the name they already have succeeds and changes nothing.

With --json the command prints only the user as the API's data object, the same user resource PATCH /api/admin/users/{publicId} returns: publicId, name, email, emailVerifiedAt, roles, disabled, createdAt and updatedAt.

Exit codes

Code Meaning
0 Name changed, or it was already the given name
1 No user has the email address or public ID, or another error occurred; the message says why
2 The name is empty or longer than 255 characters