v5

latestSwagger 2.0MIT2026-08-03485217850.7 KB
admin

Search users according filter conditions

get/admin/users

Query parameters

source_idinteger

ID of the user's login source to search for

login_namestring

identifier of the user, provided by the external authenticator

pageinteger

page number of results to return (1-based)

limitinteger

page size of results

sortstring

sort users by attribute. Supported values are "name", "created", "updated" and "id". Default is "name"

orderstring

sort order, either "asc" (ascending) or "desc" (descending). Default is "asc", ignored if "sort" is not specified.

qstring

search term (username, full name, email)

visibilitystring

visibility filter. Supported values are "public", "limited" and "private".

is_activeboolean

filter active users

is_adminboolean

filter admin users

is_restrictedboolean

filter restricted users

is_2fa_enabledboolean

filter 2FA enabled users

is_prohibit_loginboolean

filter login prohibited users

Response

UserList

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