Sign up a new user

POST /alpha/signup/{name}/

application/json

Body Required

school_id string

The school ID of the user
grade integer

The grade of the user
year integer

The year that the user graduates

Responses

200 application/json

User signed up successfully
Hide response attribute Show response attribute object
- creation_date string
  
  user creation date in UNIX milliseconds
500 application/json

Internal server error
Hide response attribute Show response attribute object
- message string
409 application/json

User already exists
Hide response attribute Show response attribute object
- message string
400 application/json

Bad request (e.g., invalid name provided)
Hide response attribute Show response attribute object
- message string
403 application/json

auth header is missing or invalid
Hide response attribute Show response attribute object
- message string
401 application/json

auth header is missing or invalid
Hide response attribute Show response attribute object
- message string

POST /alpha/signup/{name}/

curl \
 -X POST http://localhost:8080/alpha/signup/{name}/ \
 -H "auth: $API_KEY" \
 -H "Content-Type: application/json" \
 -d '{"school_id":"string","grade":11,"year":2026}'

Request example

{
  "school_id": "string",
  "grade": 11,
  "year": 2026
}

Response examples (200)

{
  "creation_date": "string"
}

Response examples (500)

{
  "message": "Failed to read from database"
}

Response examples (409)

{
  "message": "User already exists"
}

Response examples (400)

{
  "message": "Invalid request body"
}

Response examples (403)

{
  "message": "Auth failed, invalid token"
}

Response examples (401)

{
  "message": "Auth failed, invalid token"
}