Auth
9 endpoints — 5 GET, 4 POST
GET /api/auth
Returns links to the available authentication resource endpoints.
Responses
200Ok
GET /api/auth/config
Returns the enabled authentication methods available to the UI.
Responses
200Ok
GET /api/auth/openidconnect
Initiates the OpenID Connect authentication flow (redirects to the OIDC provider).
Responses
204No content
GET /api/auth/openidconnect/callback
OpenID Connect callback — exchanges the authorization code for a session.
Responses
204No content
GET /api/auth/profile
Returns the profile of the currently authenticated user.
Responses
200Ok401Unauthorized404Not Found
POST /api/auth/create-user
Creates a new user. Requires admin privileges.
Request Body
| Field | Type | Required | Description |
|---|---|---|---|
username | string | Yes | |
password | string | Yes | |
email | string | Yes | |
gitAccount | string | Yes | |
admin | boolean | No |
Responses
200Ok403Forbidden500Internal Server Error
POST /api/auth/gitAccount
Updates the Git account (username) of a user. Admins may update any user; non-admins may only update their own account.
Request Body
| Field | Type | Required | Description |
|---|---|---|---|
username | string | No | |
id | string | No | |
gitAccount | string | Yes |
Responses
204No content400Bad Request401Unauthorized403Forbidden404Not Found500Internal Server Error
POST /api/auth/login
Authenticates the user with a username/password strategy. The appropriate passport strategy is selected dynamically based on configuration.
Responses
200Ok
POST /api/auth/logout
Logs out the current user and clears the session cookie.
Responses
200Ok