POST /auth/register

Módulo Horario exposes two registration endpoints. The public /auth/register route creates DOCENTE accounts; attempting to pass role: ADMIN on this route is explicitly blocked and returns 403. To create an ADMIN account you must call /auth/register-admin and supply the X-Admin-Key header whose value must match the ADMIN_CREATION_KEY environment variable on the server. Base URL: http://localhost:8001

Creates a DOCENTE user account. Any caller may use this endpoint — no authentication is required.

Request body

nombre

string

required

Full display name of the teacher.

correo

string

required

Email address. Must be unique across all accounts.

password

string

required

Plain-text password. The server stores a bcrypt hash; the original value is never persisted.

role

string

default:"DOCENTE"

Must be DOCENTE. Passing ADMIN returns 403.

matricula

string

Optional staff or employee ID number.

turno

string

default:"AMBOS"

Teaching shift. Accepted values: MATUTINO, VESPERTINO, AMBOS.

Response

201 — created
400 — validation error
403 — forbidden

integer

Auto-assigned primary key.

matricula

string | null

Employee ID if provided.

nombre

string

Display name.

correo

string

Email address.

rol

string

Always DOCENTE for this endpoint.

turno

string

Teaching shift.

estado

boolean

Account active status; true by default.

Returned when a required field is missing or the email is already registered.

{ "detail": "correo ya registrado" }

Returned when role is set to ADMIN.

{
  "detail": "Para crear administradores usa /auth/register-admin con la clave adecuada"
}

Example

curl -s -X POST http://localhost:8001/auth/register \
  -H "Content-Type: application/json" \
  -d '{
    "nombre": "Ana García",
    "correo": "[email protected]",
    "password": "s3cr3t0!",
    "role": "DOCENTE",
    "turno": "MATUTINO"
  }'