API PROFESSIONALE CRONLUME · V1

Costruire, operare e recuperare
ogni cron da API.

Console di riferimento completo e live testing per operazioni professionali di cron. Collegare una chiave API dedicata, modificare i parametri reali e ispezionare la risposta esatta restituita dal vostro spazio di lavoro CronLume.

25 operazioni documentateJSON corpi di richiesta e rispostaCuscinetto autenticazione

URL del BASE DELLA PRODUZIONEhttps://api.cronlume.com/v1AUTENZIONEAuthorization: Bearer crl_live_…

Le chiavi sono create e revocate sotto Dashboard → chiavi API.

⌁

LIVE API CONSOLE

Collegare la chiave API

La chiave rimane nella memoria di questa pagina e viene inviata solo al punto finale che si verifica esplicitamente. Non viene mai aggiunto ad esempi, URL o archiviazione del browser.

Chiave API CronLume

Non collegato

API DOMAIN

Autenticazione

Verificare le credenziali e identificare lo spazio di lavoro attivo.

G/account

Verificare la connessione API

Convalida il tasto Bearer e restituisci l'identità chiave API autenticata e lo spazio di lavoro. La console interattiva utilizza questo endpoint quando viene selezionato Connect.

PermessoQualsiasi chiave API attiva

Richiesta di esempio

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

Esempio

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"
        }
    }
}

Possibili risposte

200Richiesta completata con successo

401chiave API mancante, non valida o scaduta

403Permesso insufficiente

422Richiesta di convalida fallita

Preparare il modulo di prova interattivo...

API DOMAIN

Lavori in Cron

Creare, ispezionare, pianificare e controllare le operazioni di cron HTTP.

G/crons

Lista e ricerca lavori di cron

Restituisce lavori ordinati per urgenza operativa. Combina filtri per individuare rapidamente un progetto, stato incidente o endpoint.

PermessoQualsiasi chiave API

Richiesta campi

Parametri di query

searchstringaFacoltativo

Titolo, URL e descrizione.

Esempio: invoices

statusEnumeroFacoltativo

in attesa, sano, degradato, giù o in pausa.

Esempio: down

activebooleanFacoltativo

Filtra i lavori attivi o disabilitati.

Esempio: true

group_idUUFacoltativo

Filtra per gruppo di progetto/sito.

category_idUUFacoltativo

Filtra per categoria.

limitIntegroFacoltativo

1–100.

Esempio: 50

offsetIntegroFacoltativo

Paginazione offset. Predefiniti a 0.

Esempio: 0

Richiesta di esempio

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"

Esempio

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
    }
}

Possibili risposte

200Richiesta completata con successo

401chiave API mancante, non valida o scaduta

403Permesso insufficiente

422Richiesta di convalida fallita

Preparare il modulo di prova interattivo...

POST/crons

Creare un lavoro di cron

Creare un programma HTTP completamente monitorato. I campi richiesti sono intenzionalmente minimi; ogni salvaguardia operativa può essere configurata nella stessa richiesta.

PermessoChiave API abilitata allo scritto

Richiesta campi

Corpo JSON

namestringaObbligo

Titolo leggibile dall'uomo usato nella ricerca, negli avvisi e nei termini di incidente.

Esempio: Generate customer invoices

urlURL paginaObbligo

HTTP o HTTPS endpoint chiamato dal lavoratore di esecuzione. Non inserire mai le credenziali nell'URL.

Esempio: https://billing.example.com/tasks/invoices

cron_expressionstringaObbligo

Standard cinque campi espressione crontab: minuto, ora, giorno del mese, mese e giorno della settimana.

Esempio: */15 * * * *

descriptionstringaFacoltativo

Scopo operativo e contesto sicuro per i rispondenti. Massimo 600 caratteri.

Esempio: Creates invoices for completed billing periods.

criticalityEnumeroFacoltativo

standard, importante o critico. Predefiniti di importante.

Esempio: critical

methodEnumeroFacoltativo

GET, POST, PUT, PATCH, DELETE o HEAD. Predefiniti del GET.

Esempio: POST

headersoggettoFacoltativo

Intestazioni di richiesta HTTP. Memorizzato criptato. Non includerli nelle richieste di supporto.

Esempio: {"Authorization":"Bearer service-token"}

bodystringaFacoltativo

Corpo di richiesta HTTP raw inviato al punto finale.

Esempio: {"source":"cronlume"}

group_idUUIDFacoltativo

Gruppo esistente nello stesso spazio di lavoro.

category_idsUUID[]Facoltativo

Identificatori di categoria esistenti nello stesso spazio di lavoro.

Esempio: []

timezoneIANA timezoneFacoltativo

Timezone usato per valutare l'espressione cron. Predefiniti per UTC.

Esempio: Europe/Brussels

timeout_secondsIntegroFacoltativo

Durata massima totale della richiesta. Sono supportati endpoint a lungo termine. Predefiniti a 120.

Esempio: 180

connect_timeout_secondsIntegroFacoltativo

Tempo massimo di connessione. Predefiniti a 15.

Esempio: 20

follow_redirectsbooleanFacoltativo

Seguire i reindirizzamenti HTTP. Predefiniti.

Esempio: 1

verify_tlsbooleanFacoltativo

Verificare il certificato TLS remoto. Tenere attivato in produzione.

Esempio: 1

expected_status_minIntegroFacoltativo

Lo stato HTTP più basso considerato di successo. Predefiniti a 200.

Esempio: 200

expected_status_maxIntegroFacoltativo

Stato HTTP più alto considerato di successo. Predefiniti a 399.

Esempio: 399

max_retriesIntegroFacoltativo

Ulteriori tentativi dopo una richiesta fallita. Predefiniti a 2.

Esempio: 2

retry_backoff_secondsIntegroFacoltativo

Ritardo tra tentativi di retry. Predefiniti a 30.

Esempio: 30

failure_thresholdIntegroFacoltativo

Esecuzioni fallite consecutive prima che il lavoro venga considerato in calo. Predefiniti a 2.

Esempio: 3

recovery_thresholdIntegroFacoltativo

I successi consecutivi necessari per risolvere un incidente. Predefiniti a 1.

Esempio: 1

alert_repeat_minutesIntegroFacoltativo

Intervallo di ripetizione per avvisi di incidente persistenti. Predefiniti a 15.

Esempio: 15

grace_secondsIntegroFacoltativo

Scheduling periodo di grazia prima di una corsa mancata è considerato in ritardo. Predefiniti a 60.

Esempio: 60

alert_on_pausebooleanFacoltativo

Invia avvisi quando il lavoro viene disattivato automaticamente o manualmente. Predefiniti.

Esempio: 1

failure_action_enabledbooleanFacoltativo

Chiama un URL di emergenza quando viene raggiunta la striscia di guasto configurata.

Esempio: 1

failure_action_thresholdIntegroFacoltativo

Contare il guasto che attiva l'URL di emergenza. Gamma 1-20.

Esempio: 3

failure_action_urlURLAFacoltativo

URL HTTP(S) di emergenza. Deve differire dall'URL primario.

Esempio: https://backup.example.com/recover/invoices

is_activebooleanFacoltativo

Creare il lavoro attivo o in pausa. Predefiniti.

Esempio: 1

Richiesta di esempio

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"
}'

Esempio

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"
        ]
    }
}

Possibili risposte

201Lavoro Cron creato

401Chiave API non valida

422Campo mancante, espressione cron non valida o URL di emergenza non valido

Preparare il modulo di prova interattivo...

G/crons/{cron_id}

Recuperare un lavoro di cron

Ritorna la configurazione completa e lo stato operativo corrente, tra cui intestazioni di richiesta decifrate per uso di ingegneria autorizzato. Trattare la risposta come sensibile.

PermessoQualsiasi chiave API

Richiesta campi

Parametri del percorso

cron_idsentiero UUIDObbligo

Identificatore di lavoro Cron.

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

Richiesta di esempio

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

Esempio

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"
        ]
    }
}

Possibili risposte

200Lavoro Cron restituito

401Chiave API non valida

404Lavoro Cron non trovato in questo spazio di lavoro

Preparare il modulo di prova interattivo...

PATTO/crons/{cron_id}

Modificare la configurazione del cron

Aggiorna uno o più campi supportati. I campi omessi conservano i valori attuali. Cambiare il programma o la zona del tempo calcola il prossimo run at.

PermessoChiave API abilitata allo scritto

Richiesta campi

Parametri del percorso

cron_idsentiero UUIDObbligo

Identificatore di lavoro Cron.

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

Corpo JSON

namestringaFacoltativo

Titolo leggibile dall'uomo usato nella ricerca, negli avvisi e nei termini di incidente.

Esempio: Generate customer invoices

urlURL paginaFacoltativo

HTTP o HTTPS endpoint chiamato dal lavoratore di esecuzione. Non inserire mai le credenziali nell'URL.

Esempio: https://billing.example.com/tasks/invoices

cron_expressionstringaFacoltativo

Standard cinque campi espressione crontab: minuto, ora, giorno del mese, mese e giorno della settimana.

Esempio: */15 * * * *

descriptionstringaFacoltativo

Scopo operativo e contesto sicuro per i rispondenti. Massimo 600 caratteri.

Esempio: Creates invoices for completed billing periods.

criticalityEnumeroFacoltativo

standard, importante o critico. Predefiniti di importante.

Esempio: critical

methodEnumeroFacoltativo

GET, POST, PUT, PATCH, DELETE o HEAD. Predefiniti del GET.

Esempio: POST

headersoggettoFacoltativo

Intestazioni di richiesta HTTP. Memorizzato criptato. Non includerli nelle richieste di supporto.

Esempio: {"Authorization":"Bearer service-token"}

bodystringaFacoltativo

Corpo di richiesta HTTP raw inviato al punto finale.

Esempio: {"source":"cronlume"}

group_idUUIDFacoltativo

Gruppo esistente nello stesso spazio di lavoro.

category_idsUUID[]Facoltativo

Identificatori di categoria esistenti nello stesso spazio di lavoro.

Esempio: []

timezoneIANA timezoneFacoltativo

Timezone usato per valutare l'espressione cron. Predefiniti per UTC.

Esempio: Europe/Brussels

timeout_secondsIntegroFacoltativo

Durata massima totale della richiesta. Sono supportati endpoint a lungo termine. Predefiniti a 120.

Esempio: 180

connect_timeout_secondsIntegroFacoltativo

Tempo massimo di connessione. Predefiniti a 15.

Esempio: 20

follow_redirectsbooleanFacoltativo

Seguire i reindirizzamenti HTTP. Predefiniti.

Esempio: 1

verify_tlsbooleanFacoltativo

Verificare il certificato TLS remoto. Tenere attivato in produzione.

Esempio: 1

expected_status_minIntegroFacoltativo

Lo stato HTTP più basso considerato di successo. Predefiniti a 200.

Esempio: 200

expected_status_maxIntegroFacoltativo

Stato HTTP più alto considerato di successo. Predefiniti a 399.

Esempio: 399

max_retriesIntegroFacoltativo

Ulteriori tentativi dopo una richiesta fallita. Predefiniti a 2.

Esempio: 2

retry_backoff_secondsIntegroFacoltativo

Ritardo tra tentativi di retry. Predefiniti a 30.

Esempio: 30

failure_thresholdIntegroFacoltativo

Esecuzioni fallite consecutive prima che il lavoro venga considerato in calo. Predefiniti a 2.

Esempio: 3

recovery_thresholdIntegroFacoltativo

I successi consecutivi necessari per risolvere un incidente. Predefiniti a 1.

Esempio: 1

alert_repeat_minutesIntegroFacoltativo

Intervallo di ripetizione per avvisi di incidente persistenti. Predefiniti a 15.

Esempio: 15

grace_secondsIntegroFacoltativo

Scheduling periodo di grazia prima di una corsa mancata è considerato in ritardo. Predefiniti a 60.

Esempio: 60

alert_on_pausebooleanFacoltativo

Invia avvisi quando il lavoro viene disattivato automaticamente o manualmente. Predefiniti.

Esempio: 1

failure_action_enabledbooleanFacoltativo

Chiama un URL di emergenza quando viene raggiunta la striscia di guasto configurata.

Esempio: 1

failure_action_thresholdIntegroFacoltativo

Contare il guasto che attiva l'URL di emergenza. Gamma 1-20.

Esempio: 3

failure_action_urlURLAFacoltativo

URL HTTP(S) di emergenza. Deve differire dall'URL primario.

Esempio: https://backup.example.com/recover/invoices

is_activebooleanFacoltativo

Creare il lavoro attivo o in pausa. Predefiniti.

Esempio: 1

Richiesta di esempio

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
}'

Esempio

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"
        ]
    }
}

Possibili risposte

200Richiesta completata con successo

401chiave API mancante, non valida o scaduta

403Permesso insufficiente

422Richiesta di convalida fallita

Preparare il modulo di prova interattivo...

DELETE/crons/{cron_id}

Eliminare permanentemente un lavoro di cron

Eliminare il lavoro e la sua cronologia di esecuzione. Questa operazione è permanente e non restituisce corpo di risposta.

PermessoChiave API abilitata allo scritto

Richiesta campi

Parametri del percorso

cron_idsentiero UUIDObbligo

Identificatore di lavoro Cron.

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

Richiesta di esempio

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

Esempio

204

No response body

Possibili risposte

204Lavoro Cron e cronologia relativa cancellato

401Chiave API non valida

404Lavoro Cron non trovato

Preparare il modulo di prova interattivo...

POST/crons/{cron_id}/activate

Attivare o riattivare un cron

Cancella la data di pausa e la ragione, ripristina le serrature e calcola l'esecuzione successiva.

PermessoChiave API abilitata allo scritto

Richiesta campi

Parametri del percorso

cron_idsentiero UUIDObbligo

Identificatore di lavoro Cron.

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

Richiesta di esempio

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"

Esempio

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"
        ]
    }
}

Possibili risposte

200Stato Cron cambiato

401Chiave API non valida

404Lavoro Cron non trovato

Preparare il modulo di prova interattivo...

POST/crons/{cron_id}/deactivate

Disabilitare un cron

Interrompe le esecuzioni future e registra l'esatto timestamp di pausa UTC e la ragione API.

PermessoChiave API abilitata allo scritto

Richiesta campi

Parametri del percorso

cron_idsentiero UUIDObbligo

Identificatore di lavoro Cron.

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

Richiesta di esempio

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"

Esempio

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"
        ]
    }
}

Possibili risposte

200Stato Cron cambiato

401Chiave API non valida

404Lavoro Cron non trovato

Preparare il modulo di prova interattivo...

POST/crons/{cron_id}/run

Esecuzione immediata

Sposta il prossimo run at all'ora UTC corrente. Il programmatore accetta il lavoro in modo asincrono.

PermessoChiave API abilitata allo scritto

Richiesta campi

Parametri del percorso

cron_idsentiero UUIDObbligo

Identificatore di lavoro Cron.

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

Richiesta di esempio

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"

Esempio

202

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

Possibili risposte

202Esecuzione in coda

409Cron è inattivo; riattivarlo prima

401Chiave API non valida

404Lavoro Cron non trovato

Preparare il modulo di prova interattivo...

POST/crons/bulk-activate

Riattivare più lavori di cron

Riattivare i lavori disabilitati selezionati dopo un'interruzione del server o un incidente risolto. I identificatori non noti o già attivi vengono ignorati.

PermessoChiave API abilitata allo scritto

Richiesta campi

Corpo JSON

job_idsUUID[]Obbligo

Identificatori di cron unici per riattivare. Massimo lotto raccomandato: 200.

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

Richiesta di esempio

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"
    ]
}'

Esempio

200

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

Possibili risposte

200Richiesta completata con successo

401chiave API mancante, non valida o scaduta

403Permesso insufficiente

422Richiesta di convalida fallita

Preparare il modulo di prova interattivo...

POST/crons/{cron_id}/duplicate

Duplica un cron in modo sicuro

Creare una copia operativa esatta, incluse categorie, canali di avviso, intestazioni crittografate e corpo di richiesta. La copia viene sempre messa in pausa e chiaramente denominata in modo da poter essere esaminata prima dell'attivazione senza causare una doppia esecuzione.

PermessoChiave API abilitata allo scritto

Richiesta campi

Parametri del percorso

cron_idsentiero UUIDObbligo

Identificatore di lavoro cron sorgente.

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

Richiesta di esempio

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"

Esempio

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"
    }
}

Possibili risposte

201duplicato pausato creato

401Chiave API non valida

404Lavoro di cron di origine non trovato

Preparare il modulo di prova interattivo...

POST/crons/bulk-pause

Pausa più lavori di cron

Pausa fino a 200 posti di lavoro attivi in una sola operazione. CronLume registra l'esatto tempo di pausa UTC e una ragione sviluppatore-API su ogni lavoro interessato. I identificatori sconosciuti, inaccessibili e già in pausa vengono segnalati come ignorati.

PermessoChiave API abilitata allo scritto

Richiesta campi

Corpo JSON

job_idsUUID[]Obbligo

Identificatori di cron unici da mettere in pausa. Massimo 200.

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

Richiesta di esempio

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"
    ]
}'

Esempio

200

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

Possibili risposte

200Richiesta completata con successo

401chiave API mancante, non valida o scaduta

403Permesso insufficiente

422Richiesta di convalida fallita

Preparare il modulo di prova interattivo...

POST/crons/bulk-move

Sposta più lavori di cron in un gruppo

Spostare fino a 200 posti di lavoro in un progetto, sito web, servizio o gruppo di clienti. Invia group id come null per rendere i lavori selezionati non raggruppati. Possono essere utilizzati solo lavori e gruppi dello spazio di lavoro autenticato.

PermessoChiave API abilitata allo scritto

Richiesta campi

Corpo JSON

job_idsUUID[]Obbligo

Identificatori di cron unici per muoversi. Massimo 200.

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

group_idUUIDObbligo

Identificazione del gruppo di destinazione, o null per Ungrouped.

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

Richiesta di esempio

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"
}'

Esempio

200

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

Possibili risposte

200Richiesta completata con successo

401chiave API mancante, non valida o scaduta

403Permesso insufficiente

422Richiesta di convalida fallita

Preparare il modulo di prova interattivo...

API DOMAIN

Esecuzioni

Indaga tempistiche, risultati HTTP, ripetizioni e azioni di emergenza.

G/crons/{cron_id}/executions

Elenco storia dell'esecuzione

Ispezionare il tempo di risposta, lo stato HTTP, le restrizioni e le prove di risposta sicure per un singolo cron. La più recente esecuzione viene restituita prima.

PermessoQualsiasi chiave API

Richiesta campi

Parametri del percorso

cron_idsentiero UUIDObbligo

Identificatore di lavoro Cron.

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

Parametri di query

limitIntegroFacoltativo

1-200.

Esempio: 50

Richiesta di esempio

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"

Esempio

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"
        }
    ]
}

Possibili risposte

200Richiesta completata con successo

401chiave API mancante, non valida o scaduta

403Permesso insufficiente

422Richiesta di convalida fallita

Preparare il modulo di prova interattivo...

G/crons/{cron_id}/failure-actions

Elenca le esecuzioni di emergenza-azione

Ispezionare ogni invocazione URL di recupero innescata da una regola consecutiva.

PermessoQualsiasi chiave API

Richiesta campi

Parametri del percorso

cron_idsentiero UUIDObbligo

Identificatore di lavoro Cron.

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

Parametri di query

limitIntegroFacoltativo

1-200.

Esempio: 50

Richiesta di esempio

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"

Esempio

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"
        }
    ]
}

Possibili risposte

200Richiesta completata con successo

401chiave API mancante, non valida o scaduta

403Permesso insufficiente

422Richiesta di convalida fallita

Preparare il modulo di prova interattivo...

API DOMAIN

Organizzazione

Struttura flotte per progetto, sito web, servizio, cliente e categoria operativa.

G/groups

Elenco gruppi

Restituisce ogni progetto, sito web, servizio o altro configurato nello spazio di lavoro autenticato.

PermessoQualsiasi chiave API

Richiesta di esempio

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

Esempio

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"
        }
    ]
}

Possibili risposte

200Richiesta completata con successo

401chiave API mancante, non valida o scaduta

403Permesso insufficiente

422Richiesta di convalida fallita

Preparare il modulo di prova interattivo...

POST/groups

Crea gruppo

Creare un progetto riutilizzabile, sito web, servizio o altro per organizzare la flotta cron.

PermessoChiave API abilitata allo scritto

Richiesta campi

Corpo JSON

namestringaObbligo

Nome unico del gruppo all'interno dello spazio di lavoro.

Esempio: Billing platform

group_typeEnumeroFacoltativo

progetto, sito web, servizio o altro.

Esempio: service

client_referenceTraduzione:Facoltativo

Cliente, contratto o riferimento interno. Massimo 160 caratteri.

Esempio: CLIENT-ACME-0042

descriptionTraduzione:Facoltativo

Scopo e contesto di proprietà.

Esempio: Customer billing automation

colorcolore esagonaleFacoltativo

Colore del display.

Esempio: #147d64

Richiesta di esempio

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"
}'

Esempio

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"
    }
}

Possibili risposte

201Gruppi creati

401Chiave API non valida

422Valori non validi o duplicati

Preparare il modulo di prova interattivo...

PATTO/groups/{group_id}

Gruppo di aggiornamento

Cambia uno o più campi. I campi omessi rimangono invariati.

PermessoChiave API abilitata allo scritto

Richiesta campi

Parametri del percorso

group_idsentiero UUIDObbligo

Identificatore di gruppi.

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

Corpo JSON

namestringaFacoltativo

Nome unico del gruppo all'interno dello spazio di lavoro.

Esempio: Billing platform

group_typeEnumeroFacoltativo

progetto, sito web, servizio o altro.

Esempio: service

client_referenceTraduzione:Facoltativo

Cliente, contratto o riferimento interno. Massimo 160 caratteri.

Esempio: CLIENT-ACME-0042

descriptionTraduzione:Facoltativo

Scopo e contesto di proprietà.

Esempio: Customer billing automation

colorcolore esagonaleFacoltativo

Colore del display.

Esempio: #147d64

Richiesta di esempio

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"
}'

Esempio

200

{
    "updated": true
}

Possibili risposte

200Richiesta completata con successo

401chiave API mancante, non valida o scaduta

403Permesso insufficiente

422Richiesta di convalida fallita

Preparare il modulo di prova interattivo...

DELETE/groups/{group_id}

Elimina gruppo

Eliminare la voce organizzativa. I lavori rimangono disponibili; i rapporti di gruppo eliminati diventano vuoti.

PermessoChiave API abilitata allo scritto

Richiesta campi

Parametri del percorso

group_idsentiero UUIDObbligo

Identificatore di gruppi.

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

Richiesta di esempio

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

Esempio

204

No response body

Possibili risposte

204Gruppo voce cancellato

401Chiave API non valida

404Articolo non trovato

Preparare il modulo di prova interattivo...

G/categories

Elenco delle categorie

Restituisce ogni categoria operativa configurata nello spazio di lavoro autenticato.

PermessoQualsiasi chiave API

Richiesta di esempio

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

Esempio

200

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

Possibili risposte

200Richiesta completata con successo

401chiave API mancante, non valida o scaduta

403Permesso insufficiente

422Richiesta di convalida fallita

POST/categories

Creare categorie

Creare una categoria operativa riutilizzabile per organizzare la flotta cron.

PermessoChiave API abilitata allo scritto

Richiesta campi

Corpo JSON

namestringaObbligo

Nome di categoria unico all'interno dello spazio di lavoro.

Esempio: Billing

descriptionTraduzione:Facoltativo

Descrizione della categoria operativa.

Esempio: Invoice and payment workflows

colorcolore esagonaleFacoltativo

Colore del display.

Esempio: #46769b

Richiesta di esempio

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"
}'

Esempio

201

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

Possibili risposte

201Categorie create

401Chiave API non valida

422Valori non validi o duplicati

Preparare il modulo di prova interattivo...

PATTO/categories/{category_id}

Aggiornamento delle categorie

Cambia uno o più campi. I campi omessi rimangono invariati.

PermessoChiave API abilitata allo scritto

Richiesta campi

Parametri del percorso

category_idsentiero UUIDObbligo

Categorie identificatore.

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

Corpo JSON

namestringaFacoltativo

Nome di categoria unico all'interno dello spazio di lavoro.

Esempio: Billing

descriptionTraduzione:Facoltativo

Descrizione della categoria operativa.

Esempio: Invoice and payment workflows

colorcolore esagonaleFacoltativo

Colore del display.

Esempio: #46769b

Richiesta di esempio

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"
}'

Esempio

200

{
    "updated": true
}

Possibili risposte

200Richiesta completata con successo

401chiave API mancante, non valida o scaduta

403Permesso insufficiente

422Richiesta di convalida fallita

Preparare il modulo di prova interattivo...

DELETE/categories/{category_id}

Cancella le categorie

Eliminare la voce organizzativa. I lavori rimangono disponibili; i rapporti di gruppo eliminati diventano vuoti.

PermessoChiave API abilitata allo scritto

Richiesta campi

Parametri del percorso

category_idsentiero UUIDObbligo

Categorie identificatore.

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

Richiesta di esempio

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

Esempio

204

No response body

Possibili risposte

204Categorie elemento cancellato

401Chiave API non valida

404Articolo non trovato

Preparare il modulo di prova interattivo...

API DOMAIN

Incidenti

Leggere e riconoscere i guasti che richiedono un'attenzione professionale.

G/incidents

Elenco degli incidenti

Ritorna fino a 500 incidenti ordinati per l'apertura. Le risposte contengono storia operativa aperta, riconosciuta e risolta.

PermessoQualsiasi chiave API

Richiesta di esempio

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

Esempio

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
        }
    ]
}

Possibili risposte

200Richiesta completata con successo

401chiave API mancante, non valida o scaduta

403Permesso insufficiente

422Richiesta di convalida fallita

Preparare il modulo di prova interattivo...

POST/incidents/{incident_id}/acknowledge

Riconoscere un incidente

Segnare un incidente aperto come riconosciuto e registrare il tempo esatto di riconoscimento UTC.

PermessoChiave API abilitata allo scritto

Richiesta campi

Parametri del percorso

incident_idsentiero integerenteObbligo

Identificatore incidente.

Esempio: 731

Richiesta di esempio

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

Esempio

200

{
    "acknowledged": true
}

Possibili risposte

200Richiesta completata con successo

401chiave API mancante, non valida o scaduta

403Permesso insufficiente

422Richiesta di convalida fallita

Preparare il modulo di prova interattivo...

Costruire, operare e recuperareogni cron da API.

Collegare la chiave API

Verificare la connessione API

Richiesta di esempio

Esempio

Possibili risposte

Lista e ricerca lavori di cron

Richiesta campi

Parametri di query

Richiesta di esempio

Esempio

Possibili risposte

Creare un lavoro di cron

Richiesta campi

Corpo JSON

Richiesta di esempio

Esempio

Possibili risposte

Recuperare un lavoro di cron

Richiesta campi

Parametri del percorso

Richiesta di esempio

Esempio

Possibili risposte

Modificare la configurazione del cron

Richiesta campi

Parametri del percorso

Corpo JSON

Richiesta di esempio

Esempio

Possibili risposte

Eliminare permanentemente un lavoro di cron

Richiesta campi

Parametri del percorso

Richiesta di esempio

Esempio

Possibili risposte

Attivare o riattivare un cron

Richiesta campi

Parametri del percorso

Richiesta di esempio

Esempio

Possibili risposte

Disabilitare un cron

Richiesta campi

Parametri del percorso

Richiesta di esempio

Esempio

Possibili risposte

Esecuzione immediata

Richiesta campi

Parametri del percorso

Richiesta di esempio

Esempio

Possibili risposte

Riattivare più lavori di cron

Richiesta campi

Corpo JSON

Richiesta di esempio

Esempio

Possibili risposte

Duplica un cron in modo sicuro

Richiesta campi

Parametri del percorso

Richiesta di esempio

Esempio

Possibili risposte

Pausa più lavori di cron

Richiesta campi

Corpo JSON

Richiesta di esempio

Esempio

Possibili risposte

Sposta più lavori di cron in un gruppo

Richiesta campi

Corpo JSON

Richiesta di esempio

Esempio

Possibili risposte

Elenco storia dell'esecuzione

Costruire, operare e recuperare
ogni cron da API.