Courses API — manage the course catalog

The Courses API manages PlataformaEduca’s institution-wide course catalog. All four CRUD operations — list, create, update, and delete — are available to any authenticated user. No special role is required beyond a valid JWT; the API enforces no further authorization distinctions between staff, teachers, or administrators. Base URL: /api/cursos Auth: All endpoints require a Bearer token in the Authorization header.

GET /api/cursos
POST /api/cursos
PUT /api/cursos/{id}
DELETE /api/cursos/{id}

List all courses

Returns a JSON array of every Curso record in the system.

Response fields

integer

Unique course ID, assigned by the database on creation.

nombre

string

Human-readable course name (e.g. "Matemáticas").

descripcion

string

Short description of the course content.

creditos

integer

Number of academic credit hours assigned to this course.

estado

boolean

Whether the course is currently active. Defaults to true on creation.

Example

cURL

curl --request GET \
  --url http://localhost:8080/api/cursos \
  --header 'Authorization: Bearer <your-token>'

Response

[
  {
    "id": 1,
    "nombre": "Matemáticas",
    "descripcion": "Álgebra y geometría",
    "creditos": 4,
    "estado": true
  },
  {
    "id": 2,
    "nombre": "Comunicación",
    "descripcion": "Lenguaje y redacción",
    "creditos": 3,
    "estado": true
  }
]

Create a course

Creates a new Curso record. The estado field is set to true automatically; you do not need to include it in the request body.

Request body

nombre

string

required

Course name.

descripcion

string

required

Short description of the course content.

creditos

integer

required

Number of academic credit hours.

Example

cURL

curl --request POST \
  --url http://localhost:8080/api/cursos \
  --header 'Authorization: Bearer <your-token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "nombre": "Programación",
    "descripcion": "Fundamentos de programación",
    "creditos": 4
  }'

Response

{
  "id": 3,
  "nombre": "Programación",
  "descripcion": "Fundamentos de programación",
  "creditos": 4,
  "estado": true
}

Update a course

Replaces the nombre, descripcion, and creditos fields of an existing course. Returns the full updated Curso object.

Path parameter

integer

required

The ID of the course to update.

Request body

nombre

string

required

Updated course name.

descripcion

string

required

Updated description.

creditos

integer

required

Updated credit hours.

Example

cURL

curl --request PUT \
  --url http://localhost:8080/api/cursos/3 \
  --header 'Authorization: Bearer <your-token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "nombre": "Programación Avanzada",
    "descripcion": "Estructuras de datos y algoritmos",
    "creditos": 5
  }'

Response

{
  "id": 3,
  "nombre": "Programación Avanzada",
  "descripcion": "Estructuras de datos y algoritmos",
  "creditos": 5,
  "estado": true
}

Delete a course

Permanently removes a course from the catalog. Returns a plain-text confirmation string.

Path parameter

integer

required

The ID of the course to delete.

Example

cURL

curl --request DELETE \
  --url http://localhost:8080/api/cursos/3 \
  --header 'Authorization: Bearer <your-token>'

Response

Curso eliminado

Error codes

Status	Meaning
`401 Unauthorized`	The `Authorization` header is missing or the token is invalid.
`404 Not Found`	No course exists with the given `id`. Applies to `PUT` and `DELETE`.

Auth

Courses & Grades

Role Endpoints

Courses API — manage the course catalog

List all courses

Response fields

Example

Create a course

Request body

Example

Update a course

Path parameter

Request body

Example

Delete a course

Path parameter

Example

Error codes

Build docs developers (and LLMs) love

Auth

Courses & Grades

Role Endpoints

Documentation Index

​List all courses

​Response fields

​Example

​Create a course

​Request body

​Example

​Update a course

​Path parameter

​Request body

​Example

​Delete a course

​Path parameter

​Example

​Error codes

Build docs developers (and LLMs) love

List all courses

Response fields

Example

Create a course

Request body

Example

Update a course

Path parameter

Request body

Example

Delete a course

Path parameter

Example

Error codes