CronLume
API PROFESIONAL CRONLUME · V1

Construir, operar y recuperar
cada cron por API.

Consola completa de referencia y pruebas en vivo para operaciones profesionales de cron. Conecte una clave de API dedicada, edite parámetros reales e inspeccione la respuesta exacta de su espacio de trabajo CronLume.

25 operaciones documentadasJSON órganos de solicitud y respuestaBearer autenticación
PRODUCCIÓN URL de BASEhttps://api.cronlume.com/v1AUTHENTICATION HEADERAuthorization: Bearer crl_live_…

Las claves se crean y revocan bajo Dashboard → claves de API.

⌁
LIVE API CONSOLE

Conecte su clave API

La clave permanece en la memoria de esta página y se envía sólo al punto final que prueba explícitamente. Nunca se añade a ejemplos, URLs o almacenamiento del navegador.

No conectado
API DOMAIN

Autenticación

Verifique las credenciales e identifique el espacio de trabajo activo.

#/account

Verificar la conexión API

Valida la tecla Bearer y devuelve la identidad y el espacio de trabajo API-key autenticados. La consola interactiva utiliza este punto final cuando se selecciona Connect.

PermisoCualquier clave de API activa

Solicitud de ejemplo

curl -X GET "https://api.cronlume.com/v1/account" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"

Respuesta del ejemplo

200
{
    "data": {
        "workspace": {
            "id": "81f9349b-8fd2-41ed-816a-4c673603b951",
            "name": "Acme Operations",
            "plan": "professional"
        },
        "api_key": {
            "id": "1cf3ef95-65c9-44d3-90e2-c473c0ff7a39",
            "name": "Production automation",
            "prefix": "crl_live_a8f94d",
            "last_used_at": "2026-08-28 20:08:31.000000"
        },
        "user": {
            "id": "f6e4f785-cbbe-45db-b179-467dcf61337d",
            "name": "Alex Morgan",
            "email": "alex@example.com"
        }
    }
}

Respuestas posibles

200Solicitud terminada con éxito
401Falta, invalida o expirada clave de API
403Autor insuficiente
422Pet validation failed
Preparando el formulario de prueba interactivo...
API DOMAIN

Empleos de hierro

Crear, inspeccionar, programar y controlar operaciones de cron HTTP.

#/crons

Trabajos de lista y búsqueda de cron

Devuelve empleos ordenados por urgencia operacional. Combine filtros para localizar un proyecto, estado de incidencia o punto final rápidamente.

PermisoCualquier clave de API

Campos de solicitud

Parámetros de consulta
searchcuerdaFacultativo

Título de búsqueda, URL y descripción.

Ejemplo: invoices
statusenumFacultativo

pendiente, saludable, degradado, abajo o pausado.

Ejemplo: down
activebooleanFacultativo

Filtrar trabajos activos o discapacitados.

Ejemplo: true
group_idUUIDFacultativo

Filtro por grupo de proyecto/sitio.

category_idUUIDFacultativo

Filtro por categoría.

limitenteroFacultativo

1–100. Defaults a 50.

Ejemplo: 50
offsetenteroFacultativo

Pagination offset. Predeterminados a 0.

Ejemplo: 0

Solicitud de ejemplo

curl -X GET "https://api.cronlume.com/v1/crons?search=invoices&status=down&active=true&group_id=&category_id=&limit=50&offset=0" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"

Respuesta del ejemplo

200
{
    "data": [
        {
            "id": "a870d9ac-3a0f-49bb-b8e2-5f392fffc821",
            "name": "Generate customer invoices",
            "description": "Creates invoices for completed billing periods.",
            "criticality": "critical",
            "url": "https://billing.example.com/tasks/invoices",
            "method": "POST",
            "cron_expression": "*/15 * * * *",
            "timezone": "Europe/Brussels",
            "timeout_seconds": 180,
            "failure_threshold": 3,
            "failure_action_enabled": true,
            "failure_action_threshold": 3,
            "failure_action_url": "https://backup.example.com/recover/invoices",
            "is_active": true,
            "current_status": "healthy",
            "next_run_at": "2026-08-28 20:15:00.000000",
            "last_run_at": "2026-08-28 20:00:00.000000",
            "consecutive_failures": 0,
            "group_name": "Billing platform",
            "category_ids": [
                "125976d5-c276-481c-984c-a9b4b70e477e"
            ]
        }
    ],
    "pagination": {
        "total": 1,
        "limit": 50,
        "offset": 0
    }
}

Respuestas posibles

200Solicitud terminada con éxito
401Falta, invalida o expirada clave de API
403Autor insuficiente
422Pet validation failed
Preparando el formulario de prueba interactivo...
POST/crons

Crear un trabajo de cron

Cree un programa HTTP totalmente monitoreado. Los campos requeridos son intencionalmente mínimos; cada salvaguardia operacional se puede configurar en la misma solicitud.

PermisoClave de API habilitada

Campos de solicitud

JSON body
namecuerdaNecesario

Título legible humano utilizado en búsqueda, alertas y plazos de incidentes.

Ejemplo: Generate customer invoices
urlURLNecesario

HTTP o HTTPS endpoint llamado por el trabajador de ejecución. Nunca coloque credenciales en la URL.

Ejemplo: https://billing.example.com/tasks/invoices
cron_expressioncuerdaNecesario

Expresión crontab estándar de cinco campos: minuto, hora, día de mes, mes y día de semana.

Ejemplo: */15 * * * *
descriptioncuerdaFacultativo

Objetivo operativo y contexto seguro para los equipos de respuesta. Máximo 600 caracteres.

Ejemplo: Creates invoices for completed billing periods.
criticalityenumFacultativo

estándar, importante o crítico. Defaults a important.

Ejemplo: critical
methodenumFacultativo

Vamos, POST, PUT, PATCH, DELETE o HEAD. Defaults to GET.

Ejemplo: POST
headersobjetoFacultativo

Cabeceras de petición HTTP. Almacenado encriptado. No los incluya en solicitudes de apoyo.

Ejemplo: {"Authorization":"Bearer service-token"}
bodycuerdaFacultativo

Cuerpo de solicitud de HTTP crudo enviado al punto final.

Ejemplo: {"source":"cronlume"}
group_idUUID habitnullFacultativo

Grupo existente en el mismo espacio de trabajo.

category_idsUUID[]Facultativo

Identificadores de categoría existentes en el mismo espacio de trabajo.

Ejemplo: []
timezoneIANA timezoneFacultativo

Timezone solía evaluar la expresión cron. Defaults to UTC.

Ejemplo: Europe/Brussels
timeout_secondsenteroFacultativo

Duración máxima de la solicitud total. Se admiten puntos finales de larga duración. Defaults a 120.

Ejemplo: 180
connect_timeout_secondsenteroFacultativo

Tiempo máximo de establecimiento de conexiones. Defaults a 15.

Ejemplo: 20
follow_redirectsbooleanFacultativo

Siga HTTP redirecciona. Defaults to true.

Ejemplo: 1
verify_tlsbooleanFacultativo

Verifique el certificado TLS remoto. Mantener activado en producción.

Ejemplo: 1
expected_status_minenteroFacultativo

El estado de HTTP más bajo considerado exitoso. Defaults a 200.

Ejemplo: 200
expected_status_maxenteroFacultativo

El más alto estado de HTTP considerado exitoso. Defaults a 399.

Ejemplo: 399
max_retriesenteroFacultativo

Otros intentos después de una solicitud fallida. Defaults a 2.

Ejemplo: 2
retry_backoff_secondsenteroFacultativo

Dilatación entre intentos de reingreso. Defaults a 30.

Ejemplo: 30
failure_thresholdenteroFacultativo

Consecutive failed executions before the job is considered down. Defaults a 2.

Ejemplo: 3
recovery_thresholdenteroFacultativo

Consecutive successes required to resolve an incident. Defaults a 1.

Ejemplo: 1
alert_repeat_minutesenteroFacultativo

Intervalo de repetición para alertas de incidentes persistentes. Defaults a 15.

Ejemplo: 15
grace_secondsenteroFacultativo

El período de gracia programado antes de una carrera perdida se considera tarde. Defaults a 60.

Ejemplo: 60
alert_on_pausebooleanFacultativo

Enviar alertas cuando el trabajo esté desactivado automáticamente o manualmente. Defaults to true.

Ejemplo: 1
failure_action_enabledbooleanFacultativo

Llame a una URL de emergencia cuando se alcance la estreak de fallo configurado.

Ejemplo: 1
failure_action_thresholdenteroFacultativo

No cuenta que activa la URL de emergencia. Rango 1–20.

Ejemplo: 3
failure_action_urlURL vuestranullFacultativo

URL HTTP(S) de emergencia. Debe diferir de la URL primaria.

Ejemplo: https://backup.example.com/recover/invoices
is_activebooleanFacultativo

Crear el trabajo activo o pausado. Defaults to true.

Ejemplo: 1

Solicitud de ejemplo

curl -X POST "https://api.cronlume.com/v1/crons" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  --data '{
    "name": "Generate customer invoices",
    "url": "https://billing.example.com/tasks/invoices",
    "cron_expression": "*/15 * * * *",
    "timezone": "Europe/Brussels",
    "method": "POST",
    "timeout_seconds": 180,
    "criticality": "critical",
    "failure_threshold": 3,
    "alert_on_pause": true,
    "failure_action_enabled": true,
    "failure_action_threshold": 3,
    "failure_action_url": "https://backup.example.com/recover/invoices"
}'

Respuesta del ejemplo

201
{
    "data": {
        "id": "a870d9ac-3a0f-49bb-b8e2-5f392fffc821",
        "name": "Generate customer invoices",
        "description": "Creates invoices for completed billing periods.",
        "criticality": "critical",
        "url": "https://billing.example.com/tasks/invoices",
        "method": "POST",
        "cron_expression": "*/15 * * * *",
        "timezone": "Europe/Brussels",
        "timeout_seconds": 180,
        "failure_threshold": 3,
        "failure_action_enabled": true,
        "failure_action_threshold": 3,
        "failure_action_url": "https://backup.example.com/recover/invoices",
        "is_active": true,
        "current_status": "healthy",
        "next_run_at": "2026-08-28 20:15:00.000000",
        "last_run_at": "2026-08-28 20:00:00.000000",
        "consecutive_failures": 0,
        "group_name": "Billing platform",
        "category_ids": [
            "125976d5-c276-481c-984c-a9b4b70e477e"
        ]
    }
}

Respuestas posibles

201Cron job created
401Clave de API inválida
422Campo perdido, expresión cron inválida o URL de emergencia inválida
Preparando el formulario de prueba interactivo...
#/crons/{cron_id}

Recuperar un trabajo de cron

Devuelve la configuración completa y el estado operativo actual, incluyendo encabezados de solicitud descifrados para uso de ingeniería autorizado. Tratar la respuesta como sensible.

PermisoCualquier clave de API

Campos de solicitud

Parámetros
cron_idUUID pathNecesario

Identificador de empleo de hierro.

Ejemplo: a870d9ac-3a0f-49bb-b8e2-5f392fffc821

Solicitud de ejemplo

curl -X GET "https://api.cronlume.com/v1/crons/a870d9ac-3a0f-49bb-b8e2-5f392fffc821" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"

Respuesta del ejemplo

200
{
    "data": {
        "id": "a870d9ac-3a0f-49bb-b8e2-5f392fffc821",
        "name": "Generate customer invoices",
        "description": "Creates invoices for completed billing periods.",
        "criticality": "critical",
        "url": "https://billing.example.com/tasks/invoices",
        "method": "POST",
        "cron_expression": "*/15 * * * *",
        "timezone": "Europe/Brussels",
        "timeout_seconds": 180,
        "failure_threshold": 3,
        "failure_action_enabled": true,
        "failure_action_threshold": 3,
        "failure_action_url": "https://backup.example.com/recover/invoices",
        "is_active": true,
        "current_status": "healthy",
        "next_run_at": "2026-08-28 20:15:00.000000",
        "last_run_at": "2026-08-28 20:00:00.000000",
        "consecutive_failures": 0,
        "group_name": "Billing platform",
        "category_ids": [
            "125976d5-c276-481c-984c-a9b4b70e477e"
        ]
    }
}

Respuestas posibles

200Cron job returned
401Clave de API inválida
404Trabajo de hierro no encontrado en este espacio de trabajo
Preparando el formulario de prueba interactivo...
PATCH/crons/{cron_id}

Cambio de configuración cron

Actualice uno o más campos compatibles. Los campos omitidos mantienen sus valores actuales. Cambio de horario o zona horaria recalcula siguiente run at.

PermisoClave de API habilitada

Campos de solicitud

Parámetros
cron_idUUID pathNecesario

Identificador de empleo de hierro.

Ejemplo: a870d9ac-3a0f-49bb-b8e2-5f392fffc821
JSON body
namecuerdaFacultativo

Título legible humano utilizado en búsqueda, alertas y plazos de incidentes.

Ejemplo: Generate customer invoices
urlURLFacultativo

HTTP o HTTPS endpoint llamado por el trabajador de ejecución. Nunca coloque credenciales en la URL.

Ejemplo: https://billing.example.com/tasks/invoices
cron_expressioncuerdaFacultativo

Expresión crontab estándar de cinco campos: minuto, hora, día de mes, mes y día de semana.

Ejemplo: */15 * * * *
descriptioncuerdaFacultativo

Objetivo operativo y contexto seguro para los equipos de respuesta. Máximo 600 caracteres.

Ejemplo: Creates invoices for completed billing periods.
criticalityenumFacultativo

estándar, importante o crítico. Defaults a important.

Ejemplo: critical
methodenumFacultativo

Vamos, POST, PUT, PATCH, DELETE o HEAD. Defaults to GET.

Ejemplo: POST
headersobjetoFacultativo

Cabeceras de petición HTTP. Almacenado encriptado. No los incluya en solicitudes de apoyo.

Ejemplo: {"Authorization":"Bearer service-token"}
bodycuerdaFacultativo

Cuerpo de solicitud de HTTP crudo enviado al punto final.

Ejemplo: {"source":"cronlume"}
group_idUUID habitnullFacultativo

Grupo existente en el mismo espacio de trabajo.

category_idsUUID[]Facultativo

Identificadores de categoría existentes en el mismo espacio de trabajo.

Ejemplo: []
timezoneIANA timezoneFacultativo

Timezone solía evaluar la expresión cron. Defaults to UTC.

Ejemplo: Europe/Brussels
timeout_secondsenteroFacultativo

Duración máxima de la solicitud total. Se admiten puntos finales de larga duración. Defaults a 120.

Ejemplo: 180
connect_timeout_secondsenteroFacultativo

Tiempo máximo de establecimiento de conexiones. Defaults a 15.

Ejemplo: 20
follow_redirectsbooleanFacultativo

Siga HTTP redirecciona. Defaults to true.

Ejemplo: 1
verify_tlsbooleanFacultativo

Verifique el certificado TLS remoto. Mantener activado en producción.

Ejemplo: 1
expected_status_minenteroFacultativo

El estado de HTTP más bajo considerado exitoso. Defaults a 200.

Ejemplo: 200
expected_status_maxenteroFacultativo

El más alto estado de HTTP considerado exitoso. Defaults a 399.

Ejemplo: 399
max_retriesenteroFacultativo

Otros intentos después de una solicitud fallida. Defaults a 2.

Ejemplo: 2
retry_backoff_secondsenteroFacultativo

Dilatación entre intentos de reingreso. Defaults a 30.

Ejemplo: 30
failure_thresholdenteroFacultativo

Consecutive failed executions before the job is considered down. Defaults a 2.

Ejemplo: 3
recovery_thresholdenteroFacultativo

Consecutive successes required to resolve an incident. Defaults a 1.

Ejemplo: 1
alert_repeat_minutesenteroFacultativo

Intervalo de repetición para alertas de incidentes persistentes. Defaults a 15.

Ejemplo: 15
grace_secondsenteroFacultativo

El período de gracia programado antes de una carrera perdida se considera tarde. Defaults a 60.

Ejemplo: 60
alert_on_pausebooleanFacultativo

Enviar alertas cuando el trabajo esté desactivado automáticamente o manualmente. Defaults to true.

Ejemplo: 1
failure_action_enabledbooleanFacultativo

Llame a una URL de emergencia cuando se alcance la estreak de fallo configurado.

Ejemplo: 1
failure_action_thresholdenteroFacultativo

No cuenta que activa la URL de emergencia. Rango 1–20.

Ejemplo: 3
failure_action_urlURL vuestranullFacultativo

URL HTTP(S) de emergencia. Debe diferir de la URL primaria.

Ejemplo: https://backup.example.com/recover/invoices
is_activebooleanFacultativo

Crear el trabajo activo o pausado. Defaults to true.

Ejemplo: 1

Solicitud de ejemplo

curl -X PATCH "https://api.cronlume.com/v1/crons/a870d9ac-3a0f-49bb-b8e2-5f392fffc821" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  --data '{
    "cron_expression": "0 */2 * * *",
    "timeout_seconds": 240,
    "failure_threshold": 4
}'

Respuesta del ejemplo

200
{
    "data": {
        "id": "a870d9ac-3a0f-49bb-b8e2-5f392fffc821",
        "name": "Generate customer invoices",
        "description": "Creates invoices for completed billing periods.",
        "criticality": "critical",
        "url": "https://billing.example.com/tasks/invoices",
        "method": "POST",
        "cron_expression": "0 */2 * * *",
        "timezone": "Europe/Brussels",
        "timeout_seconds": 240,
        "failure_threshold": 4,
        "failure_action_enabled": true,
        "failure_action_threshold": 3,
        "failure_action_url": "https://backup.example.com/recover/invoices",
        "is_active": true,
        "current_status": "healthy",
        "next_run_at": "2026-08-28 20:15:00.000000",
        "last_run_at": "2026-08-28 20:00:00.000000",
        "consecutive_failures": 0,
        "group_name": "Billing platform",
        "category_ids": [
            "125976d5-c276-481c-984c-a9b4b70e477e"
        ]
    }
}

Respuestas posibles

200Solicitud terminada con éxito
401Falta, invalida o expirada clave de API
403Autor insuficiente
422Pet validation failed
Preparando el formulario de prueba interactivo...
DELETE/crons/{cron_id}

Eliminar permanentemente un trabajo de cron

Eliminar el trabajo y su historial de ejecución. Esta operación es permanente y no devuelve ningún órgano de respuesta.

PermisoClave de API habilitada

Campos de solicitud

Parámetros
cron_idUUID pathNecesario

Identificador de empleo de hierro.

Ejemplo: a870d9ac-3a0f-49bb-b8e2-5f392fffc821

Solicitud de ejemplo

curl -X DELETE "https://api.cronlume.com/v1/crons/a870d9ac-3a0f-49bb-b8e2-5f392fffc821" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"

Respuesta del ejemplo

204
No response body

Respuestas posibles

204Trabajo de hierro y historia relacionada borrados
401Clave de API inválida
404Trabajo de hierro no encontrado
Preparando el formulario de prueba interactivo...
POST/crons/{cron_id}/activate

Activar o reactivar un cron

Limpia la fecha de pausa y la razón, restablece las cerraduras y calcula la próxima ejecución.

PermisoClave de API habilitada

Campos de solicitud

Parámetros
cron_idUUID pathNecesario

Identificador de empleo de hierro.

Ejemplo: a870d9ac-3a0f-49bb-b8e2-5f392fffc821

Solicitud de ejemplo

curl -X POST "https://api.cronlume.com/v1/crons/a870d9ac-3a0f-49bb-b8e2-5f392fffc821/activate" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"

Respuesta del ejemplo

200
{
    "data": {
        "id": "a870d9ac-3a0f-49bb-b8e2-5f392fffc821",
        "name": "Generate customer invoices",
        "description": "Creates invoices for completed billing periods.",
        "criticality": "critical",
        "url": "https://billing.example.com/tasks/invoices",
        "method": "POST",
        "cron_expression": "*/15 * * * *",
        "timezone": "Europe/Brussels",
        "timeout_seconds": 180,
        "failure_threshold": 3,
        "failure_action_enabled": true,
        "failure_action_threshold": 3,
        "failure_action_url": "https://backup.example.com/recover/invoices",
        "is_active": true,
        "current_status": "pending",
        "next_run_at": "2026-08-28 20:15:00.000000",
        "last_run_at": "2026-08-28 20:00:00.000000",
        "consecutive_failures": 0,
        "group_name": "Billing platform",
        "category_ids": [
            "125976d5-c276-481c-984c-a9b4b70e477e"
        ]
    }
}

Respuestas posibles

200Cron State cambió
401Clave de API inválida
404Trabajo de hierro no encontrado
Preparando el formulario de prueba interactivo...
POST/crons/{cron_id}/deactivate

Desactivar un cron

Detiene futuras ejecuciones y registra el tiempo exacto de pausa UTC y la razón de API.

PermisoClave de API habilitada

Campos de solicitud

Parámetros
cron_idUUID pathNecesario

Identificador de empleo de hierro.

Ejemplo: a870d9ac-3a0f-49bb-b8e2-5f392fffc821

Solicitud de ejemplo

curl -X POST "https://api.cronlume.com/v1/crons/a870d9ac-3a0f-49bb-b8e2-5f392fffc821/deactivate" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"

Respuesta del ejemplo

200
{
    "data": {
        "id": "a870d9ac-3a0f-49bb-b8e2-5f392fffc821",
        "name": "Generate customer invoices",
        "description": "Creates invoices for completed billing periods.",
        "criticality": "critical",
        "url": "https://billing.example.com/tasks/invoices",
        "method": "POST",
        "cron_expression": "*/15 * * * *",
        "timezone": "Europe/Brussels",
        "timeout_seconds": 180,
        "failure_threshold": 3,
        "failure_action_enabled": true,
        "failure_action_threshold": 3,
        "failure_action_url": "https://backup.example.com/recover/invoices",
        "is_active": false,
        "current_status": "paused",
        "next_run_at": "2026-08-28 20:15:00.000000",
        "last_run_at": "2026-08-28 20:00:00.000000",
        "consecutive_failures": 0,
        "group_name": "Billing platform",
        "category_ids": [
            "125976d5-c276-481c-984c-a9b4b70e477e"
        ]
    }
}

Respuestas posibles

200Cron State cambió
401Clave de API inválida
404Trabajo de hierro no encontrado
Preparando el formulario de prueba interactivo...
POST/crons/{cron_id}/run

Realizar una ejecución inmediata

Se mueve siguiente run at a la hora actual de UTC. El programador acepta el trabajo asincrónicamente.

PermisoClave de API habilitada

Campos de solicitud

Parámetros
cron_idUUID pathNecesario

Identificador de empleo de hierro.

Ejemplo: a870d9ac-3a0f-49bb-b8e2-5f392fffc821

Solicitud de ejemplo

curl -X POST "https://api.cronlume.com/v1/crons/a870d9ac-3a0f-49bb-b8e2-5f392fffc821/run" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"

Respuesta del ejemplo

202
{
    "accepted": true,
    "cron_id": "a870d9ac-3a0f-49bb-b8e2-5f392fffc821"
}

Respuestas posibles

202Execution queued
409Cron es inactivo; reactivar primero
401Clave de API inválida
404Trabajo de hierro no encontrado
Preparando el formulario de prueba interactivo...
POST/crons/bulk-activate

Reactivar múltiples trabajos de cron

Reactivar trabajos deshabilitados seleccionados después de una salida del servidor o un incidente resuelto. Se ignoran identificadores desconocidos o ya activos.

PermisoClave de API habilitada

Campos de solicitud

JSON body
job_idsUUID[]Necesario

Identificadores únicos de cron para reactivar. Lote máximo recomendado: 200.

Ejemplo: ["a870d9ac-3a0f-49bb-b8e2-5f392fffc821"]

Solicitud de ejemplo

curl -X POST "https://api.cronlume.com/v1/crons/bulk-activate" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  --data '{
    "job_ids": [
        "a870d9ac-3a0f-49bb-b8e2-5f392fffc821"
    ]
}'

Respuesta del ejemplo

200
{
    "data": {
        "reactivated_ids": [
            "a870d9ac-3a0f-49bb-b8e2-5f392fffc821"
        ],
        "reactivated_count": 1,
        "ignored_count": 0
    }
}

Respuestas posibles

200Solicitud terminada con éxito
401Falta, invalida o expirada clave de API
403Autor insuficiente
422Pet validation failed
Preparando el formulario de prueba interactivo...
POST/crons/{cron_id}/duplicate

Duplicar un cron con seguridad

Cree una copia operativa exacta, incluyendo categorías, canales de alerta, encabezados cifrados y cuerpo de solicitud. La copia siempre se detiene y se llama claramente para que pueda ser revisada antes de la activación sin causar una doble ejecución.

PermisoClave de API habilitada

Campos de solicitud

Parámetros
cron_idUUID pathNecesario

Identificador de empleo de cron fuente.

Ejemplo: a870d9ac-3a0f-49bb-b8e2-5f392fffc821

Solicitud de ejemplo

curl -X POST "https://api.cronlume.com/v1/crons/a870d9ac-3a0f-49bb-b8e2-5f392fffc821/duplicate" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"

Respuesta del ejemplo

201
{
    "data": {
        "id": "44079c1f-a0eb-45f0-b998-0c81017b2cc2",
        "name": "Generate customer invoices (copy)",
        "description": "Creates invoices for completed billing periods.",
        "criticality": "critical",
        "url": "https://billing.example.com/tasks/invoices",
        "method": "POST",
        "cron_expression": "*/15 * * * *",
        "timezone": "Europe/Brussels",
        "timeout_seconds": 180,
        "failure_threshold": 3,
        "failure_action_enabled": true,
        "failure_action_threshold": 3,
        "failure_action_url": "https://backup.example.com/recover/invoices",
        "is_active": false,
        "current_status": "paused",
        "next_run_at": "2026-08-28 20:15:00.000000",
        "last_run_at": "2026-08-28 20:00:00.000000",
        "consecutive_failures": 0,
        "group_name": "Billing platform",
        "category_ids": [
            "125976d5-c276-481c-984c-a9b4b70e477e"
        ],
        "paused_at": "2026-08-29 14:22:00.000000",
        "pause_reason": "Duplicated safely through developer API \u2014 review before activation"
    }
}

Respuestas posibles

201duplicado usado creado
401Clave de API inválida
404Trabajo de cron fuente no encontrado
Preparando el formulario de prueba interactivo...
POST/crons/bulk-pause

Pausa múltiples trabajos de cron

Pausa hasta 200 empleos activos en una operación. CronLume registra el tiempo exacto de pausa UTC y una razón desarrollador-API en cada trabajo afectado. Los identificadores desconocidos, inaccesibles y ya pausados son reportados como ignorados.

PermisoClave de API habilitada

Campos de solicitud

JSON body
job_idsUUID[]Necesario

Identificadores únicos de cron para pausar. Máximo 200.

Ejemplo: ["a870d9ac-3a0f-49bb-b8e2-5f392fffc821"]

Solicitud de ejemplo

curl -X POST "https://api.cronlume.com/v1/crons/bulk-pause" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  --data '{
    "job_ids": [
        "a870d9ac-3a0f-49bb-b8e2-5f392fffc821"
    ]
}'

Respuesta del ejemplo

200
{
    "data": {
        "paused_ids": [
            "a870d9ac-3a0f-49bb-b8e2-5f392fffc821"
        ],
        "paused_count": 1,
        "ignored_count": 0
    }
}

Respuestas posibles

200Solicitud terminada con éxito
401Falta, invalida o expirada clave de API
403Autor insuficiente
422Pet validation failed
Preparando el formulario de prueba interactivo...
POST/crons/bulk-move

Mover múltiples trabajos de cron a un grupo

Mover hasta 200 puestos de trabajo a un proyecto, sitio web, servicio o grupo de clientes. Enviar group id como null para que los trabajos seleccionados no se agrupen. Sólo se pueden utilizar trabajos y grupos del espacio de trabajo autenticado.

PermisoClave de API habilitada

Campos de solicitud

JSON body
job_idsUUID[]Necesario

Identificadores únicos de cron para moverse. Máximo 200.

Ejemplo: ["a870d9ac-3a0f-49bb-b8e2-5f392fffc821"]
group_idUUID habitnullNecesario

Identificador del grupo de destino, o nulo para Ungrouped.

Ejemplo: 6ef63789-baf1-44fc-99bb-0c5ce2d37a8b

Solicitud de ejemplo

curl -X POST "https://api.cronlume.com/v1/crons/bulk-move" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  --data '{
    "job_ids": [
        "a870d9ac-3a0f-49bb-b8e2-5f392fffc821"
    ],
    "group_id": "6ef63789-baf1-44fc-99bb-0c5ce2d37a8b"
}'

Respuesta del ejemplo

200
{
    "data": {
        "moved_ids": [
            "a870d9ac-3a0f-49bb-b8e2-5f392fffc821"
        ],
        "moved_count": 1,
        "ignored_count": 0,
        "group_id": "6ef63789-baf1-44fc-99bb-0c5ce2d37a8b"
    }
}

Respuestas posibles

200Solicitud terminada con éxito
401Falta, invalida o expirada clave de API
403Autor insuficiente
422Pet validation failed
Preparando el formulario de prueba interactivo...
API DOMAIN

Ejecuciones

Investigar el tiempo, los resultados de HTTP, los registros y las acciones de emergencia.

#/crons/{cron_id}/executions

Historial de ejecución

Inspect response time, HTTP status, retries and safe response evidence for a single cron. La ejecución más reciente se devuelve primero.

PermisoCualquier clave de API

Campos de solicitud

Parámetros
cron_idUUID pathNecesario

Identificador de empleo de hierro.

Ejemplo: a870d9ac-3a0f-49bb-b8e2-5f392fffc821
Parámetros de consulta
limitenteroFacultativo

1–200. Defaults a 50.

Ejemplo: 50

Solicitud de ejemplo

curl -X GET "https://api.cronlume.com/v1/crons/a870d9ac-3a0f-49bb-b8e2-5f392fffc821/executions?limit=50" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"

Respuesta del ejemplo

200
{
    "data": [
        {
            "id": 18492,
            "job_id": "a870d9ac-3a0f-49bb-b8e2-5f392fffc821",
            "scheduled_at": "2026-08-28 20:00:00.000000",
            "started_at": "2026-08-28 20:00:00.143000",
            "finished_at": "2026-08-28 20:00:01.381000",
            "duration_ms": 1238,
            "status": "succeeded",
            "attempt": 1,
            "http_status": 200,
            "error_type": null,
            "error_message": null,
            "response_excerpt": "{\"processed\":42}",
            "worker_id": "scheduler-eu-01"
        }
    ]
}

Respuestas posibles

200Solicitud terminada con éxito
401Falta, invalida o expirada clave de API
403Autor insuficiente
422Pet validation failed
Preparando el formulario de prueba interactivo...
#/crons/{cron_id}/failure-actions

List emergency-action executions

Inspeccione cada invocación URL de recuperación desencadenada por una regla de falla consecutiva.

PermisoCualquier clave de API

Campos de solicitud

Parámetros
cron_idUUID pathNecesario

Identificador de empleo de hierro.

Ejemplo: a870d9ac-3a0f-49bb-b8e2-5f392fffc821
Parámetros de consulta
limitenteroFacultativo

1–200. Defaults a 50.

Ejemplo: 50

Solicitud de ejemplo

curl -X GET "https://api.cronlume.com/v1/crons/a870d9ac-3a0f-49bb-b8e2-5f392fffc821/failure-actions?limit=50" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"

Respuesta del ejemplo

200
{
    "data": [
        {
            "id": 218,
            "job_id": "a870d9ac-3a0f-49bb-b8e2-5f392fffc821",
            "trigger_failure_count": 3,
            "url": "https://backup.example.com/recover/invoices",
            "duration_ms": 842,
            "status": "succeeded",
            "http_status": 204,
            "worker_id": "scheduler-eu-01"
        }
    ]
}

Respuestas posibles

200Solicitud terminada con éxito
401Falta, invalida o expirada clave de API
403Autor insuficiente
422Pet validation failed
Preparando el formulario de prueba interactivo...
API DOMAIN

Organisation

Estructura flotas por proyecto, sitio web, servicio, cliente y categoría operativa.

#/groups

Grupos de lista

Devuelve cada proyecto, sitio web, servicio u otro configurado en el espacio de trabajo autenticado.

PermisoCualquier clave de API

Solicitud de ejemplo

curl -X GET "https://api.cronlume.com/v1/groups" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"

Respuesta del ejemplo

200
{
    "data": [
        {
            "id": "6ef63789-baf1-44fc-99bb-0c5ce2d37a8b",
            "group_type": "service",
            "name": "Billing platform",
            "client_reference": "CLIENT-ACME-0042",
            "description": "Customer billing automation",
            "color": "#147d64"
        }
    ]
}

Respuestas posibles

200Solicitud terminada con éxito
401Falta, invalida o expirada clave de API
403Autor insuficiente
422Pet validation failed
Preparando el formulario de prueba interactivo...
POST/groups

Crear grupo

Crear un proyecto reutilizable, sitio web, servicio u otro para organizar la flota de cron.

PermisoClave de API habilitada

Campos de solicitud

JSON body
namecuerdaNecesario

Nombre único del grupo dentro del espacio de trabajo.

Ejemplo: Billing platform
group_typeenumFacultativo

proyecto, sitio web, servicio u otro.

Ejemplo: service
client_referencecadena perpetuanullFacultativo

Cliente, contrato o referencia interna. Máximo 160 caracteres.

Ejemplo: CLIENT-ACME-0042
descriptioncadena perpetuanullFacultativo

Propósito y contexto de propiedad.

Ejemplo: Customer billing automation
colorcolor hexFacultativo

Color de pantalla de panel.

Ejemplo: #147d64

Solicitud de ejemplo

curl -X POST "https://api.cronlume.com/v1/groups" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  --data '{
    "group_type": "service",
    "name": "Billing platform",
    "client_reference": "CLIENT-ACME-0042",
    "description": "Customer billing automation",
    "color": "#147d64"
}'

Respuesta del ejemplo

201
{
    "data": {
        "id": "6ef63789-baf1-44fc-99bb-0c5ce2d37a8b",
        "group_type": "service",
        "name": "Billing platform",
        "client_reference": "CLIENT-ACME-0042",
        "description": "Customer billing automation",
        "color": "#147d64"
    }
}

Respuestas posibles

201Grupos creados
401Clave de API inválida
422Valores inválidos o duplicados
Preparando el formulario de prueba interactivo...
PATCH/groups/{group_id}

Grupo de actualización

Cambiar uno o más campos. Los campos omitidos siguen sin cambiar.

PermisoClave de API habilitada

Campos de solicitud

Parámetros
group_idUUID pathNecesario

Grupos identificadores.

Ejemplo: 6ef63789-baf1-44fc-99bb-0c5ce2d37a8b
JSON body
namecuerdaFacultativo

Nombre único del grupo dentro del espacio de trabajo.

Ejemplo: Billing platform
group_typeenumFacultativo

proyecto, sitio web, servicio u otro.

Ejemplo: service
client_referencecadena perpetuanullFacultativo

Cliente, contrato o referencia interna. Máximo 160 caracteres.

Ejemplo: CLIENT-ACME-0042
descriptioncadena perpetuanullFacultativo

Propósito y contexto de propiedad.

Ejemplo: Customer billing automation
colorcolor hexFacultativo

Color de pantalla de panel.

Ejemplo: #147d64

Solicitud de ejemplo

curl -X PATCH "https://api.cronlume.com/v1/groups/6ef63789-baf1-44fc-99bb-0c5ce2d37a8b" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  --data '{
    "name": "Billing platform Production"
}'

Respuesta del ejemplo

200
{
    "updated": true
}

Respuestas posibles

200Solicitud terminada con éxito
401Falta, invalida o expirada clave de API
403Autor insuficiente
422Pet validation failed
Preparando el formulario de prueba interactivo...
DELETE/groups/{group_id}

Grupo Suprímase

Eliminar el elemento organizativo. Los trabajos permanecen disponibles; las relaciones de grupo eliminadas se vacían.

PermisoClave de API habilitada

Campos de solicitud

Parámetros
group_idUUID pathNecesario

Grupos identificadores.

Ejemplo: 6ef63789-baf1-44fc-99bb-0c5ce2d37a8b

Solicitud de ejemplo

curl -X DELETE "https://api.cronlume.com/v1/groups/6ef63789-baf1-44fc-99bb-0c5ce2d37a8b" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"

Respuesta del ejemplo

204
No response body

Respuestas posibles

204Tema de los grupos suprimido
401Clave de API inválida
404Tema no encontrado
Preparando el formulario de prueba interactivo...
#/categories

Lista de categorías

Devuelve cada categoría operacional configurada en el espacio de trabajo autenticado.

PermisoCualquier clave de API

Solicitud de ejemplo

curl -X GET "https://api.cronlume.com/v1/categories" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"

Respuesta del ejemplo

200
{
    "data": [
        {
            "id": "125976d5-c276-481c-984c-a9b4b70e477e",
            "name": "Billing",
            "description": "Invoice and payment workflows",
            "color": "#46769b"
        }
    ]
}

Respuestas posibles

200Solicitud terminada con éxito
401Falta, invalida o expirada clave de API
403Autor insuficiente
422Pet validation failed
Preparando el formulario de prueba interactivo...
POST/categories

Crear categorie

Crear una categoría operacional reutilizable para organizar la flota de cron.

PermisoClave de API habilitada

Campos de solicitud

JSON body
namecuerdaNecesario

Nombre único de categoría dentro del espacio de trabajo.

Ejemplo: Billing
descriptioncadena perpetuanullFacultativo

Descripción de la categoría operativa.

Ejemplo: Invoice and payment workflows
colorcolor hexFacultativo

Color de pantalla de panel.

Ejemplo: #46769b

Solicitud de ejemplo

curl -X POST "https://api.cronlume.com/v1/categories" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  --data '{
    "name": "Billing",
    "description": "Invoice and payment workflows",
    "color": "#46769b"
}'

Respuesta del ejemplo

201
{
    "data": {
        "id": "125976d5-c276-481c-984c-a9b4b70e477e",
        "name": "Billing",
        "description": "Invoice and payment workflows",
        "color": "#46769b"
    }
}

Respuestas posibles

201Categorías creadas
401Clave de API inválida
422Valores inválidos o duplicados
Preparando el formulario de prueba interactivo...
PATCH/categories/{category_id}

Actualizar categorie

Cambiar uno o más campos. Los campos omitidos siguen sin cambiar.

PermisoClave de API habilitada

Campos de solicitud

Parámetros
category_idUUID pathNecesario

Categorías identificador.

Ejemplo: 125976d5-c276-481c-984c-a9b4b70e477e
JSON body
namecuerdaFacultativo

Nombre único de categoría dentro del espacio de trabajo.

Ejemplo: Billing
descriptioncadena perpetuanullFacultativo

Descripción de la categoría operativa.

Ejemplo: Invoice and payment workflows
colorcolor hexFacultativo

Color de pantalla de panel.

Ejemplo: #46769b

Solicitud de ejemplo

curl -X PATCH "https://api.cronlume.com/v1/categories/125976d5-c276-481c-984c-a9b4b70e477e" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  --data '{
    "name": "Billing Production"
}'

Respuesta del ejemplo

200
{
    "updated": true
}

Respuestas posibles

200Solicitud terminada con éxito
401Falta, invalida o expirada clave de API
403Autor insuficiente
422Pet validation failed
Preparando el formulario de prueba interactivo...
DELETE/categories/{category_id}

Delete categorie

Eliminar el elemento organizativo. Los trabajos permanecen disponibles; las relaciones de grupo eliminadas se vacían.

PermisoClave de API habilitada

Campos de solicitud

Parámetros
category_idUUID pathNecesario

Categorías identificador.

Ejemplo: 125976d5-c276-481c-984c-a9b4b70e477e

Solicitud de ejemplo

curl -X DELETE "https://api.cronlume.com/v1/categories/125976d5-c276-481c-984c-a9b4b70e477e" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"

Respuesta del ejemplo

204
No response body

Respuestas posibles

204Categorías artículo eliminado
401Clave de API inválida
404Tema no encontrado
Preparando el formulario de prueba interactivo...
API DOMAIN

Incidentes

Lea y reconozca fallos que requieren atención profesional.

#/incidents

Número de incidentes

Regrese a 500 incidentes ordenados por hora de apertura. Las respuestas contienen un historial operacional abierto, reconocido y resuelto.

PermisoCualquier clave de API

Solicitud de ejemplo

curl -X GET "https://api.cronlume.com/v1/incidents" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"

Respuesta del ejemplo

200
{
    "data": [
        {
            "id": 731,
            "job_id": "a870d9ac-3a0f-49bb-b8e2-5f392fffc821",
            "cron_name": "Generate customer invoices",
            "status": "open",
            "severity": "critical",
            "summary": "Generate customer invoices failed 3 times",
            "details": "Remote endpoint returned HTTP 503.",
            "failure_count": 3,
            "opened_at": "2026-08-28 20:00:02.000000",
            "acknowledged_at": null,
            "resolved_at": null
        }
    ]
}

Respuestas posibles

200Solicitud terminada con éxito
401Falta, invalida o expirada clave de API
403Autor insuficiente
422Pet validation failed
Preparando el formulario de prueba interactivo...
POST/incidents/{incident_id}/acknowledge

Reconocimiento de un incidente

Marcar un incidente abierto como reconocido y registrar el tiempo exacto de reconocimiento UTC.

PermisoClave de API habilitada

Campos de solicitud

Parámetros
incident_idcamino enteroNecesario

Identificador de incidentes.

Ejemplo: 731

Solicitud de ejemplo

curl -X POST "https://api.cronlume.com/v1/incidents/731/acknowledge" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"

Respuesta del ejemplo

200
{
    "acknowledged": true
}

Respuestas posibles

200Solicitud terminada con éxito
401Falta, invalida o expirada clave de API
403Autor insuficiente
422Pet validation failed
Preparando el formulario de prueba interactivo...