v5

latestSwagger 2.0MIT2026-08-03485217850.7 KB
admin

Create a user

post/admin/users

Request body

created_atstring date-time

For explicitly setting the user creation timestamp. Useful when users are migrated from other systems. When omitted, the user's creation timestamp will be set to "now".

emailstring required
full_namestring

The full display name of the user

login_namestring

identifier of the user, provided by the external authenticator (if configured)

must_change_passwordboolean

Whether the user must change password on first login

passwordstring

The plain text password for the user

restrictedboolean

Whether the user has restricted access privileges

send_notifyboolean

Whether to send welcome notification email to the user

source_idinteger

The authentication source ID to associate with the user

usernamestring required

username of the user

visibility'public' | 'limited' | 'private'

User visibility level: public, limited, or private

Response

User

activeboolean

Is user active

avatar_urlstring

URL to the user's avatar

createdstring date-time
descriptionstring

the user's description

emailstring email
followers_countinteger

user counts

following_countinteger
full_namestring

the user's full name

html_urlstring

URL to the user's gitea page

idinteger

the user's id

is_adminboolean

Is the user an administrator

languagestring

User locale

last_loginstring date-time
locationstring

the user's location

loginstring

login of the user, same as username

login_namestring

identifier of the user, provided by the external authenticator (if configured)

prohibit_loginboolean

Is user login prohibited

restrictedboolean

Is user restricted

source_idinteger

The ID of the user's Authentication Source

starred_repos_countinteger
visibility'public' | 'limited' | 'private'

User visibility level option: public, limited, private

websitestring

the user's website