Ciclos

Obtener ciclos

Obtener los ciclos educativos con los que cuenta el campus

Request
query Parameters
limit
integer [ 1 .. 100 ]
Default: 100

Límite de sub-ciclos

page
integer >= 1
Default: 1

Número de página de consulta

is_active
boolean

Obtener sub-ciclos activos o inactivos (true o false)

header Parameters
algebraix-api-token
required
string = 32 characters

ALGEBRAIX API KEY

Example: 52ffa931bfe0b15415e548672837315e
algebraix-debug-mode
boolean
Default: false

La instancia debug se puede utilizar para hacer pruebas sin afectar a los usuarios del sistema

NOTA: La instancia se crea desde web.

Responses
200

No error

400

Bad parameters

401

Authorization Required

get/cycles
Request samples
Response samples
application/json
[
  • {
    }
]

Agregar ciclo

Crea un ciclo escolar con la misma lógica que la pantalla web Ciclos → Agregar. Un ciclo cuyo name ya exista (sin distinguir mayúsculas) se rechaza con 400. El ciclo se crea a nivel escuela (no corporativo) y sin habilitación Mattilda.

Request
header Parameters
algebraix-api-token
required
string = 32 characters

ALGEBRAIX API KEY

Example: 52ffa931bfe0b15415e548672837315e
algebraix-debug-mode
boolean
Default: false

La instancia debug se puede utilizar para hacer pruebas sin afectar a los usuarios del sistema

NOTA: La instancia se crea desde web.

Request Body schema: application/json
required
name
required
string [ 1 .. 256 ] characters

Nombre del ciclo (único)

description
string

Descripción del ciclo

additional_info
Array of strings <= 3 items

Información adicional (hasta 3 textos, se guardan como additional_info_1..3)

is_active
boolean

Si el ciclo nace activo (por omisión false, igual que la casilla de la pantalla web)

Responses
200

No error

400

Bad parameters

401

Authorization Required

post/cycles
Request samples
application/json
{
  • "name": "2026-2027",
  • "is_active": true
}
Response samples
application/json
{
  • "details": [ ],
  • "id": "AWDSFER4",
  • "message": "Cycle added"
}