GT-ADMIN-USER-EDIT(1)          gitea-cli Manual          GT-ADMIN-USER-EDIT(1)



NAME
       gt-admin-user-edit - Edit an account



SYNOPSIS
       gt admin user edit <username> [flags]



DESCRIPTION
       Edit an account


   JSON FIELDS
       active, admin, created_at, description, email, full_name, id, location,
       prohibit_login, restricted, url, username, visibility, website



OPTIONS
       --active[=false]    Activate account (use =false to revoke)


       --admin[=false]     Administrator privileges (use =false to revoke)


       --allow-create-organization[=false]     Allow creating organizations
       (use =false to revoke)


       --allow-git-hook[=false]      Allow Git hooks (use =false to revoke)


       --allow-import-local[=false]  Allow local repository imports (use
       =false to revoke)


       --description=""    Profile description


       --email=""     Email address


       --full-name=""      Display name


       -h, --help[=false]  help for edit


       --location=""  Location


       --max-repo-creation=0    Repository creation limit (-1 uses the
       instance default)


       --must-change-password[=false]     Require password change on next
       sign-in (use =false to disable)


       --password=""  Password (prefer --password-file)


       --password-file=""  Read password from file or - for stdin; remove one
       trailing line ending


       --prohibit-login[=false]      Prohibit signing in (use =false to
       revoke)


       --restricted[=false]     Restrict account access (use =false to revoke)


       --visibility=""     Profile visibility {public|limited|private}


       --website=""   Website URL



OPTIONS INHERITED FROM PARENT COMMANDS
       --csv[=""]     Output CSV with the specified comma-separated fields, or
       all fields


       --debug[=false]     Log the method, URL, status, and duration of each
       HTTP request to stderr


       --host=""      Gitea instance URL, including any base path


       --interactive[=false]    Allow prompts with machine output


       -q, --jq=""    Filter JSON output using a jq expression; implies --json


       --json[=""]    Output JSON with the specified comma-separated fields,
       or all fields


       --no-input[=false]  Disable prompts and implicit editor/browser
       interactions


       --sudo=""      Perform API requests as this user (requires an
       administrator account)


       --user=""      Account name on the selected instance



EXAMPLE
       $ gt admin user edit bob --full-name "Bob Builder" --restricted
       # reset a password and require a new one on the next sign-in
       $ gt admin user edit bob --password-file pw.txt --must-change-password
       # revoke administrator privileges
       $ gt admin user edit bob --admin=false



SEE ALSO
       gt-admin-user(1)

gitea-cli                          Nov 2026              GT-ADMIN-USER-EDIT(1)