Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/Daniel-Stojanovski/finkiopendesk/llms.txt

Use this file to discover all available pages before exploring further.

Registers a new student account using a @students.finki.ukim.mk academic email address. The endpoint creates the user record, generates a short-lived JWT activation token, and dispatches a formal activation email via SendGrid. The token returned here is not a login token — it is only used as the token field in the subsequent activate student request.
This endpoint is public. No authentication is required.

Request

POST https://finkiopendesk-be.onrender.com/auth/students/create
email
string
required
The student’s academic email address. Must be a valid @students.finki.ukim.mk address.

Response

The response body is a plain JWT string (not a JSON object). This token encodes the new user’s UUID as its subject claim and is intended exclusively for the activation flow.
(body)
string
A JWT activation token. Pass this value as token in POST /auth/students/activate to complete account setup.

Example

curl -X POST \
  "https://finkiopendesk-be.onrender.com/auth/students/create?email=student@students.finki.ukim.mk"
The activation token has a short expiry. If the student does not activate in time, a new registration request must be submitted.

Build docs developers (and LLMs) love