table of contents
| glab(1) | glab(1) |
NAME¶
glab-service-account-update - Update a service account.
SYNOPSIS¶
glab service-account update [flags]
DESCRIPTION¶
Update the name, username, or email address of a service account of a project or a group, by its ID or username.
- Only the given fields change. At least one of --name, --username, or --email is required.
- A field cannot be cleared, so an empty value is rejected.
- A numeric argument is always treated as an ID. IDs and usernames come from glab service-account list.
- A new custom email address must be confirmed before the account uses it, unless the top-level group has a matching verified domain or email confirmation is turned off on the instance. Until then, the address is shown as the unconfirmed email.
- The username of a service account associated with a composite identity cannot be changed.
Updating a group service account requires GitLab 17.10 or later. Changing the email address requires GitLab 18.2 or later.
OPTIONS¶
--email="" New email address of the service account.
-g, --group="" Update a service account of a group instead of a project. Accepts a group ID or full path.
--jq="" Filter JSON output with a jq expression.
--name="" New name of the service account.
-F, --output="text" Format output as: text, json.
-R, --repo="" Select another repository. You can use either OWNER/REPO or GROUP/NAMESPACE/REPO. The full URL or Git URL is also accepted.
--username="" New username of the service account.
OPTIONS INHERITED FROM PARENT COMMANDS¶
-h, --help[=false] Show help for this command.
EXAMPLE¶
# Rename service account 42 of the current project glab service-account update 42 --name "Release bot" # Change the username of a service account, found by its current username glab service-account update release-bot --username release-bot-2 # Change the email address of a service account of a specific project glab service-account update 42 --email release-bot@example.com --repo user/my-repo # Rename a group's service account glab service-account update 42 --name "Release bot" --group my-group
SEE ALSO¶
| Nov 2026 | Auto generated by spf13/cobra |