Users

Endpoints for managing users

[ADMIN] Get all users

get

Retrieves a list of all users. Required admin role

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Responses

200

OK

*/*

idinteger · int64Required

Unique identifier of the user

Example: 1

usernamestringRequired

Username of the user

Example: john_doe

401

Unauthorized

*/*

403

Forbidden

*/*

409

Conflict

*/*

500

Internal Server Error

*/*

get/api/users

GET /api/users HTTP/1.1
Host: localhost:8080
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

[
  {
    "id": 1,
    "username": "john_doe"
  }
]

[ADMIN] Create user

post

Create user with provided data. Required admin role.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

musernamestring · min: 1Required

Username of the user

Example: john_doe

mpasswordstring · min: 1Required

Password of the user

Example: securepassword123

namestringOptional

Full name of the user

Example: John Doe

Responses

200

OK

*/*

idinteger · int64Required

Unique identifier of the user

Example: 1

usernamestringRequired

Username of the user

Example: john_doe

401

Unauthorized

*/*

403

Forbidden

*/*

409

Conflict

*/*

500

Internal Server Error

*/*

post/api/users

POST /api/users HTTP/1.1
Host: localhost:8080
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 74

{
  "musername": "john_doe",
  "mpassword": "securepassword123",
  "name": "John Doe"
}

{
  "id": 1,
  "username": "john_doe"
}

[ADMIN] Link user to competition

post

Links a user to a competition. Required admin role.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

Request to link a user to a competition

userIdinteger · int64Required

ID of the user

Example: 1

competitionIdinteger · int64Required

ID of the competition

Example: 1001

Responses

200

OK

*/*

Response indicating success

statusstringRequired

Status of the response

Example: OK

401

Unauthorized

*/*

403

Forbidden

*/*

409

Conflict

*/*

500

Internal Server Error

*/*

post/api/users/link

POST /api/users/link HTTP/1.1
Host: localhost:8080
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 33

{
  "userId": 1,
  "competitionId": 1001
}

{
  "status": "OK"
}

Change password

post

Changes the password for the current user. Requires current password verification.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

currentPasswordstringRequired

newPasswordstringRequired

Responses

200

OK

*/*

Response indicating success

statusstringRequired

Status of the response

Example: OK

401

Unauthorized

*/*

403

Forbidden

*/*

409

Conflict

*/*

500

Internal Server Error

*/*

post/api/users/change-password

POST /api/users/change-password HTTP/1.1
Host: localhost:8080
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 47

{
  "currentPassword": "text",
  "newPassword": "text"
}

{
  "status": "OK"
}

Get current user

get

Retrieves current user.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Responses

200

OK

*/*

musernamestringOptional

mpasswordstringOptional

namestringOptional

idinteger · int64Optional

createdAtstring · date-timeOptional

updatedAtstring · date-timeOptional

isAdminbooleanRequired

usernamestringOptional

passwordstringOptional

enabledbooleanOptional

credentialsNonExpiredbooleanOptional

accountNonExpiredbooleanOptional

accountNonLockedbooleanOptional

401

Unauthorized

*/*

403

Forbidden

*/*

409

Conflict

*/*

500

Internal Server Error

*/*

get/api/users/me

GET /api/users/me HTTP/1.1
Host: localhost:8080
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "musername": "text",
  "mpassword": "text",
  "name": "text",
  "roles": [
    "USER"
  ],
  "id": 1,
  "createdAt": "2026-01-01T00:00:00.000Z",
  "updatedAt": "2026-01-01T00:00:00.000Z",
  "authorities": [
    {
      "authority": "text"
    }
  ],
  "isAdmin": true,
  "username": "text",
  "password": "text",
  "enabled": true,
  "credentialsNonExpired": true,
  "accountNonExpired": true,
  "accountNonLocked": true
}