Delete a user

DELETE

/admin/users/{username}

const url = 'https://gitea.example.com/api/v1/admin/users/example';
const options = {method: 'DELETE', headers: {Authorization: 'Basic <credentials>'}};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request DELETE \
  --url https://gitea.example.com/api/v1/admin/users/example \
  --header 'Authorization: Basic <credentials>'

Authorizations

BasicAuth
Token
AccessToken
AuthorizationHeaderToken
SudoParam
SudoHeader
TOTPHeader

Parameters

Path Parameters

username

required

string

Username of the user to delete

Query Parameters

purge

boolean

Purge the user from the system completely

Responses

204

APIEmpty is an empty response

application/json

403

APIForbiddenError is a forbidden error response

application/json

Headers

message

string

url

string

404

APINotFound is a not found empty response

application/json

422

APIValidationError is error format response related to input validation

application/json

Headers

message

string

url

string