CronLume
API PROFESSIONNELLE CRONLUME · V1

Construire, exploiter et récupérer
chaque cron par API.

Complete référence et console de test en direct pour les opérations cron professionnelles. Connectez une clé API dédiée, modifiez les paramètres réels et inspectez la réponse exacte retournée par votre espace de travail CronLume.

25 opérations documentéesJSON organismes de demande et de réponseAu porteur authentification
URL de base de productionhttps://api.cronlume.com/v1HEADER DE L'AUTENTICATIONAuthorization: Bearer crl_live_…

Les clés sont créées et révoquées en vertu Tableau de bord → touches API.

⌁
CONSOLE D'API VIVANTE

Connectez votre clé API

La clé reste dans la mémoire de cette page et n'est envoyée qu'au paramètre que vous testez explicitement. Il n'est jamais ajouté à des exemples, URLs ou le stockage du navigateur.

Non connecté
DOMAINE D'API

Authentification

Vérifier les identifiants et identifier l'espace de travail actif.

Allez/account

Vérifier la connexion à l'API

Valider la clé du porteur et retourner l'identité authentifiée API-key et l'espace de travail. La console interactive utilise ce paramètre lorsque Connect est sélectionné.

AutorisationToute clé API active

Exemple de requête

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

Exemple de réponse

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

Réponses possibles

200Demande effectuée avec succès
401Clé API manquante, invalide ou expirée
403Autorisation insuffisante
422La validation de la demande a échoué
Préparer le formulaire de test interactif...
DOMAINE D'API

Cron emplois

Créer, inspecter, programmer et contrôler les opérations HTTP cron.

Allez/crons

Liste et recherche d'emplois cron

Retourne les travaux commandés par urgence opérationnelle. Combiner des filtres pour localiser rapidement un projet, un état d'incident ou un paramètre.

AutorisationToute clé API

Champs de demande

Paramètres de requête
searchchaîneFacultatif

Titre de la recherche, URL et description.

Exemple : invoices
statusenumFacultatif

en attente, en bonne santé, dégradée, descendante ou suspendue.

Exemple : down
activebooléenFacultatif

Filtrer les emplois actifs ou handicapés.

Exemple : true
group_idUUIDFacultatif

Filtrer par projet/groupe de site.

category_idUUIDFacultatif

Filtrer par catégorie.

limitentierFacultatif

1–100. Par défaut à 50.

Exemple : 50
offsetentierFacultatif

Pagination offset. Par défaut à 0.

Exemple : 0

Exemple de requête

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"

Exemple de réponse

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

Réponses possibles

200Demande effectuée avec succès
401Clé API manquante, invalide ou expirée
403Autorisation insuffisante
422La validation de la demande a échoué
Préparer le formulaire de test interactif...
POSTE/crons

Créer un tâche cron

Créer un programme HTTP entièrement surveillé. Les champs obligatoires sont volontairement minimes; chaque sauvegarde opérationnelle peut être configurée dans la même requête.

AutorisationClé API compatible avec l'écriture

Champs de demande

Corps JSON
namechaîneRequis

Titre lisible par l'homme utilisé dans la recherche, les alertes et les délais d'incident.

Exemple : Generate customer invoices
urlURLRequis

Endpoint HTTP ou HTTPS appelé par le worker d'exécution. Ne jamais placer d'identifiants dans l'URL.

Exemple : https://billing.example.com/tasks/invoices
cron_expressionchaîneRequis

Expression standard à cinq champs : minute, heure, jour du mois, mois et jour de la semaine.

Exemple : */15 * * * *
descriptionchaîneFacultatif

Objectif opérationnel et contexte sécuritaire pour les intervenants. Maximum 600 caractères.

Exemple : Creates invoices for completed billing periods.
criticalityenumFacultatif

standard, important ou critique. Par défaut.

Exemple : critical
methodenumFacultatif

Prends, Post, Put, Patch, Delete ou la tête. Par défaut pour GET.

Exemple : POST
headersobjetFacultatif

En-têtes de requête HTTP. Stocké crypté. Ne pas les inclure dans les demandes de soutien.

Exemple : {"Authorization":"Bearer service-token"}
bodychaîneFacultatif

Corps brut de requête HTTP envoyé au paramètre.

Exemple : {"source":"cronlume"}
group_idNULLFacultatif

Groupe existant dans le même espace de travail.

category_idsUUID[]Facultatif

Identificateurs de catégorie existants dans le même espace de travail.

Exemple : []
timezonefuseau horaire IANAFacultatif

Timezone utilisé pour évaluer l'expression cron. Par défaut vers UTC.

Exemple : Europe/Brussels
timeout_secondsentierFacultatif

Durée maximale totale de la demande. Les paramètres à long terme sont pris en charge. Par défaut à 120.

Exemple : 180
connect_timeout_secondsentierFacultatif

Durée maximale de connexion-établissement. Par défaut à 15.

Exemple : 20
follow_redirectsbooléenFacultatif

Suivez les redirections HTTP. Par défaut.

Exemple : 1
verify_tlsbooléenFacultatif

Vérifier le certificat TLS à distance. Maintenir activé dans la production.

Exemple : 1
expected_status_minentierFacultatif

Le statut HTTP le plus bas considéré comme réussi. Par défaut à 200.

Exemple : 200
expected_status_maxentierFacultatif

Statut HTTP le plus élevé considéré comme réussi. Par défaut à 399.

Exemple : 399
max_retriesentierFacultatif

Tentatives supplémentaires après l'échec d'une demande. Par défaut à 2.

Exemple : 2
retry_backoff_secondsentierFacultatif

Retard entre les tentatives de réessayer. Par défaut à 30.

Exemple : 30
failure_thresholdentierFacultatif

Les exécutions consécutives ont échoué avant que le travail ne soit considéré comme un échec. Par défaut à 2.

Exemple : 3
recovery_thresholdentierFacultatif

Succès consécutifs requis pour résoudre un incident. Par défaut à 1.

Exemple : 1
alert_repeat_minutesentierFacultatif

Répéter l'intervalle pour les alertes persistantes. Par défaut à 15.

Exemple : 15
grace_secondsentierFacultatif

La période de grâce prévue avant une course manquée est considérée comme tardive. Par défaut à 60.

Exemple : 60
alert_on_pausebooléenFacultatif

Envoyer des alertes lorsque le travail est désactivé automatiquement ou manuellement. Par défaut.

Exemple : 1
failure_action_enabledbooléenFacultatif

Appelez une URL d'urgence lorsque la séquence d'échec configurée est atteinte.

Exemple : 1
failure_action_thresholdentierFacultatif

Compte d'échec qui déclenche l'URL d'urgence. Gamme 1-20.

Exemple : 3
failure_action_urlURL=NullFacultatif

URL HTTP(S) d'urgence. Doit différer de l'URL primaire.

Exemple : https://backup.example.com/recover/invoices
is_activebooléenFacultatif

Créer l'emploi actif ou interrompu. Par défaut.

Exemple : 1

Exemple de requête

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

Exemple de réponse

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

Réponses possibles

201Cron emploi créé
401Clé API non valide
422Champ manquant, expression cron invalide ou URL d'urgence invalide
Préparer le formulaire de test interactif...
Allez/crons/{cron_id}

Récupérer un emploi

Retourner la configuration complète et l'état opérationnel actuel, y compris les en-têtes de requête décryptés pour une utilisation autorisée. Traiter la réponse comme sensible.

AutorisationToute clé API

Champs de demande

Paramètres de trajectoire
cron_idVoie UUIDRequis

Identificateur de travail Cron.

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

Exemple de requête

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

Exemple de réponse

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

Réponses possibles

200Cron travail retourné
401Clé API non valide
404Cron travail non trouvé dans cet espace de travail
Préparer le formulaire de test interactif...
PATCH/crons/{cron_id}

Modifier la configuration de cron

Mettre à jour un ou plusieurs champs supportés. Les champs oubliés conservent leurs valeurs actuelles. Changer d'horaire ou de fuseau horaire recalcule next run at.

AutorisationClé API compatible avec l'écriture

Champs de demande

Paramètres de trajectoire
cron_idVoie UUIDRequis

Identificateur de travail Cron.

Exemple : a870d9ac-3a0f-49bb-b8e2-5f392fffc821
Corps JSON
namechaîneFacultatif

Titre lisible par l'homme utilisé dans la recherche, les alertes et les délais d'incident.

Exemple : Generate customer invoices
urlURLFacultatif

Endpoint HTTP ou HTTPS appelé par le worker d'exécution. Ne jamais placer d'identifiants dans l'URL.

Exemple : https://billing.example.com/tasks/invoices
cron_expressionchaîneFacultatif

Expression standard à cinq champs : minute, heure, jour du mois, mois et jour de la semaine.

Exemple : */15 * * * *
descriptionchaîneFacultatif

Objectif opérationnel et contexte sécuritaire pour les intervenants. Maximum 600 caractères.

Exemple : Creates invoices for completed billing periods.
criticalityenumFacultatif

standard, important ou critique. Par défaut.

Exemple : critical
methodenumFacultatif

Prends, Post, Put, Patch, Delete ou la tête. Par défaut pour GET.

Exemple : POST
headersobjetFacultatif

En-têtes de requête HTTP. Stocké crypté. Ne pas les inclure dans les demandes de soutien.

Exemple : {"Authorization":"Bearer service-token"}
bodychaîneFacultatif

Corps brut de requête HTTP envoyé au paramètre.

Exemple : {"source":"cronlume"}
group_idNULLFacultatif

Groupe existant dans le même espace de travail.

category_idsUUID[]Facultatif

Identificateurs de catégorie existants dans le même espace de travail.

Exemple : []
timezonefuseau horaire IANAFacultatif

Timezone utilisé pour évaluer l'expression cron. Par défaut vers UTC.

Exemple : Europe/Brussels
timeout_secondsentierFacultatif

Durée maximale totale de la demande. Les paramètres à long terme sont pris en charge. Par défaut à 120.

Exemple : 180
connect_timeout_secondsentierFacultatif

Durée maximale de connexion-établissement. Par défaut à 15.

Exemple : 20
follow_redirectsbooléenFacultatif

Suivez les redirections HTTP. Par défaut.

Exemple : 1
verify_tlsbooléenFacultatif

Vérifier le certificat TLS à distance. Maintenir activé dans la production.

Exemple : 1
expected_status_minentierFacultatif

Le statut HTTP le plus bas considéré comme réussi. Par défaut à 200.

Exemple : 200
expected_status_maxentierFacultatif

Statut HTTP le plus élevé considéré comme réussi. Par défaut à 399.

Exemple : 399
max_retriesentierFacultatif

Tentatives supplémentaires après l'échec d'une demande. Par défaut à 2.

Exemple : 2
retry_backoff_secondsentierFacultatif

Retard entre les tentatives de réessayer. Par défaut à 30.

Exemple : 30
failure_thresholdentierFacultatif

Les exécutions consécutives ont échoué avant que le travail ne soit considéré comme un échec. Par défaut à 2.

Exemple : 3
recovery_thresholdentierFacultatif

Succès consécutifs requis pour résoudre un incident. Par défaut à 1.

Exemple : 1
alert_repeat_minutesentierFacultatif

Répéter l'intervalle pour les alertes persistantes. Par défaut à 15.

Exemple : 15
grace_secondsentierFacultatif

La période de grâce prévue avant une course manquée est considérée comme tardive. Par défaut à 60.

Exemple : 60
alert_on_pausebooléenFacultatif

Envoyer des alertes lorsque le travail est désactivé automatiquement ou manuellement. Par défaut.

Exemple : 1
failure_action_enabledbooléenFacultatif

Appelez une URL d'urgence lorsque la séquence d'échec configurée est atteinte.

Exemple : 1
failure_action_thresholdentierFacultatif

Compte d'échec qui déclenche l'URL d'urgence. Gamme 1-20.

Exemple : 3
failure_action_urlURL=NullFacultatif

URL HTTP(S) d'urgence. Doit différer de l'URL primaire.

Exemple : https://backup.example.com/recover/invoices
is_activebooléenFacultatif

Créer l'emploi actif ou interrompu. Par défaut.

Exemple : 1

Exemple de requête

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

Exemple de réponse

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

Réponses possibles

200Demande effectuée avec succès
401Clé API manquante, invalide ou expirée
403Autorisation insuffisante
422La validation de la demande a échoué
Préparer le formulaire de test interactif...
DELETE/crons/{cron_id}

Supprimer définitivement une tâche de cron

Supprimer le travail et son historique d'exécution. Cette opération est permanente et ne retourne aucun corps de réponse.

AutorisationClé API compatible avec l'écriture

Champs de demande

Paramètres de trajectoire
cron_idVoie UUIDRequis

Identificateur de travail Cron.

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

Exemple de requête

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

Exemple de réponse

204
No response body

Réponses possibles

204Cron emploi et l'historique connexe supprimé
401Clé API non valide
404Cron travail non trouvé
Préparer le formulaire de test interactif...
POSTE/crons/{cron_id}/activate

Activer ou réactiver une cron

Efface la date et la raison de la pause, réinitialise les verrous et calcule la prochaine exécution.

AutorisationClé API compatible avec l'écriture

Champs de demande

Paramètres de trajectoire
cron_idVoie UUIDRequis

Identificateur de travail Cron.

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

Exemple de requête

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"

Exemple de réponse

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

Réponses possibles

200État Cron changé
401Clé API non valide
404Cron travail non trouvé
Préparer le formulaire de test interactif...
POSTE/crons/{cron_id}/deactivate

Désactiver un cron

Arrêtez les exécutions futures et enregistrez la pause exacte UTC timestamp et API raison.

AutorisationClé API compatible avec l'écriture

Champs de demande

Paramètres de trajectoire
cron_idVoie UUIDRequis

Identificateur de travail Cron.

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

Exemple de requête

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"

Exemple de réponse

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

Réponses possibles

200État Cron changé
401Clé API non valide
404Cron travail non trouvé
Préparer le formulaire de test interactif...
POSTE/crons/{cron_id}/run

Demander une exécution immédiate

Déplace next run at à l'heure UTC actuelle. Le planificateur accepte le travail asynchrone.

AutorisationClé API compatible avec l'écriture

Champs de demande

Paramètres de trajectoire
cron_idVoie UUIDRequis

Identificateur de travail Cron.

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

Exemple de requête

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"

Exemple de réponse

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

Réponses possibles

202Exécution en file d'attente
409Cron est inactif; le réactiver d'abord
401Clé API non valide
404Cron travail non trouvé
Préparer le formulaire de test interactif...
POSTE/crons/bulk-activate

Réactiver plusieurs tâches cron

Réactiver les tâches handicapées sélectionnées après une panne de serveur ou un incident résolu. Les identifiants inconnus ou déjà actifs sont ignorés.

AutorisationClé API compatible avec l'écriture

Champs de demande

Corps JSON
job_idsUUID[]Requis

Des identifiants cron uniques à réactiver. Lot maximal recommandé: 200.

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

Exemple de requête

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

Exemple de réponse

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

Réponses possibles

200Demande effectuée avec succès
401Clé API manquante, invalide ou expirée
403Autorisation insuffisante
422La validation de la demande a échoué
Préparer le formulaire de test interactif...
POSTE/crons/{cron_id}/duplicate

Dupliquer un cron en toute sécurité

Créer une copie opérationnelle exacte, incluant les catégories, les canaux d'alerte, les en-têtes chiffrés et l'organisme de demande. La copie est toujours en pause et clairement nommée afin qu'elle puisse être revue avant l'activation sans causer une double exécution.

AutorisationClé API compatible avec l'écriture

Champs de demande

Paramètres de trajectoire
cron_idVoie UUIDRequis

Identificateur d'emploi.

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

Exemple de requête

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"

Exemple de réponse

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

Réponses possibles

201Dupliqué créé
401Clé API non valide
404Source cron emploi non trouvé
Préparer le formulaire de test interactif...
POSTE/crons/bulk-pause

Pause emplois cron multiples

Pas jusqu'à 200 emplois actifs dans une seule opération. CronLume enregistre le temps exact de pause UTC et une raison de développeur-API sur chaque emploi affecté. Les identifiants inconnus, inaccessibles et déjà interrompus sont signalés comme ignorés.

AutorisationClé API compatible avec l'écriture

Champs de demande

Corps JSON
job_idsUUID[]Requis

Des identificateurs de cron uniques pour faire une pause. Maximum 200.

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

Exemple de requête

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

Exemple de réponse

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

Réponses possibles

200Demande effectuée avec succès
401Clé API manquante, invalide ou expirée
403Autorisation insuffisante
422La validation de la demande a échoué
Préparer le formulaire de test interactif...
POSTE/crons/bulk-move

Déplacer plusieurs tâches cron dans un groupe

Déplacez jusqu'à 200 emplois dans un projet, un site Web, un service ou un groupe de clients. Envoyer group id comme null pour dégrouper les tâches sélectionnées. Seuls les emplois et les groupes de l'espace de travail authentifié peuvent être utilisés.

AutorisationClé API compatible avec l'écriture

Champs de demande

Corps JSON
job_idsUUID[]Requis

Identificateurs de cron uniques à déplacer. Maximum 200.

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

identificateur de groupe de destination, ou null pour Ungrouped.

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

Exemple de requête

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

Exemple de réponse

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

Réponses possibles

200Demande effectuée avec succès
401Clé API manquante, invalide ou expirée
403Autorisation insuffisante
422La validation de la demande a échoué
Préparer le formulaire de test interactif...
DOMAINE D'API

Exécutions

Étudier le timing, les résultats HTTP, les relevés et les mesures d'urgence.

Allez/crons/{cron_id}/executions

Liste de l'historique de l'exécution

Inspectez le temps de réponse, l'état HTTP, les relevés et la preuve de réponse sûre pour un seul cron. L'exécution la plus récente est retournée en premier.

AutorisationToute clé API

Champs de demande

Paramètres de trajectoire
cron_idVoie UUIDRequis

Identificateur de travail Cron.

Exemple : a870d9ac-3a0f-49bb-b8e2-5f392fffc821
Paramètres de requête
limitentierFacultatif

1–200. Par défaut à 50.

Exemple : 50

Exemple de requête

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"

Exemple de réponse

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

Réponses possibles

200Demande effectuée avec succès
401Clé API manquante, invalide ou expirée
403Autorisation insuffisante
422La validation de la demande a échoué
Préparer le formulaire de test interactif...
Allez/crons/{cron_id}/failure-actions

Énumérer les exécutions par action d ' urgence

Inspectez chaque invocation d'URL de récupération déclenchée par une règle d'échec consécutive.

AutorisationToute clé API

Champs de demande

Paramètres de trajectoire
cron_idVoie UUIDRequis

Identificateur de travail Cron.

Exemple : a870d9ac-3a0f-49bb-b8e2-5f392fffc821
Paramètres de requête
limitentierFacultatif

1–200. Par défaut à 50.

Exemple : 50

Exemple de requête

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"

Exemple de réponse

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

Réponses possibles

200Demande effectuée avec succès
401Clé API manquante, invalide ou expirée
403Autorisation insuffisante
422La validation de la demande a échoué
Préparer le formulaire de test interactif...
DOMAINE D'API

Organisation

Structurer les flottes par projet, site web, service, clientèle et catégorie opérationnelle.

Allez/groups

Liste des groupes

Retourner chaque projet, site Web, service ou autre configuré dans l'espace de travail authentifié.

AutorisationToute clé API

Exemple de requête

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

Exemple de réponse

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

Réponses possibles

200Demande effectuée avec succès
401Clé API manquante, invalide ou expirée
403Autorisation insuffisante
422La validation de la demande a échoué
Préparer le formulaire de test interactif...
POSTE/groups

Créer un groupe

Créer un projet réutilisable, un site web, un service ou autre pour organiser la flotte de cron.

AutorisationClé API compatible avec l'écriture

Champs de demande

Corps JSON
namechaîneRequis

Nom de groupe unique dans l'espace de travail.

Exemple : Billing platform
group_typeenumFacultatif

projet, site web, service ou autre.

Exemple : service
client_referencechaîneFacultatif

Client, contrat ou référence interne. Au maximum 160 caractères.

Exemple : CLIENT-ACME-0042
descriptionchaîneFacultatif

Objectif et contexte de propriété.

Exemple : Customer billing automation
colorcouleur hexFacultatif

Couleur du tableau de bord.

Exemple : #147d64

Exemple de requête

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

Exemple de réponse

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

Réponses possibles

201Groupes créés
401Clé API non valide
422Valeurs non valides ou dupliquées
Préparer le formulaire de test interactif...
PATCH/groups/{group_id}

Groupe de mise à jour

Changer un ou plusieurs champs. Les champs observés demeurent inchangés.

AutorisationClé API compatible avec l'écriture

Champs de demande

Paramètres de trajectoire
group_idVoie UUIDRequis

Identification des groupes.

Exemple : 6ef63789-baf1-44fc-99bb-0c5ce2d37a8b
Corps JSON
namechaîneFacultatif

Nom de groupe unique dans l'espace de travail.

Exemple : Billing platform
group_typeenumFacultatif

projet, site web, service ou autre.

Exemple : service
client_referencechaîneFacultatif

Client, contrat ou référence interne. Au maximum 160 caractères.

Exemple : CLIENT-ACME-0042
descriptionchaîneFacultatif

Objectif et contexte de propriété.

Exemple : Customer billing automation
colorcouleur hexFacultatif

Couleur du tableau de bord.

Exemple : #147d64

Exemple de requête

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

Exemple de réponse

200
{
    "updated": true
}

Réponses possibles

200Demande effectuée avec succès
401Clé API manquante, invalide ou expirée
403Autorisation insuffisante
422La validation de la demande a échoué
Préparer le formulaire de test interactif...
DELETE/groups/{group_id}

Supprimer le groupe

Supprimer l'élément organisationnel. Les emplois restent disponibles; les relations de groupe supprimées deviennent vides.

AutorisationClé API compatible avec l'écriture

Champs de demande

Paramètres de trajectoire
group_idVoie UUIDRequis

Identification des groupes.

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

Exemple de requête

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

Exemple de réponse

204
No response body

Réponses possibles

204Poste des groupes supprimé
401Clé API non valide
404Élément non trouvé
Préparer le formulaire de test interactif...
Allez/categories

Liste des catégories

Retourner toutes les catégories opérationnelles configurées dans l'espace de travail authentifié.

AutorisationToute clé API

Exemple de requête

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

Exemple de réponse

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

Réponses possibles

200Demande effectuée avec succès
401Clé API manquante, invalide ou expirée
403Autorisation insuffisante
422La validation de la demande a échoué
Préparer le formulaire de test interactif...
POSTE/categories

Créer une catégorie

Créer une catégorie opérationnelle réutilisable pour l'organisation de la flotte de cron.

AutorisationClé API compatible avec l'écriture

Champs de demande

Corps JSON
namechaîneRequis

Nom de catégorie unique dans l'espace de travail.

Exemple : Billing
descriptionchaîneFacultatif

Description de la catégorie opérationnelle.

Exemple : Invoice and payment workflows
colorcouleur hexFacultatif

Couleur du tableau de bord.

Exemple : #46769b

Exemple de requête

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

Exemple de réponse

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

Réponses possibles

201Catégories créées
401Clé API non valide
422Valeurs non valides ou dupliquées
Préparer le formulaire de test interactif...
PATCH/categories/{category_id}

Mettre à jour la catégorie

Changer un ou plusieurs champs. Les champs observés demeurent inchangés.

AutorisationClé API compatible avec l'écriture

Champs de demande

Paramètres de trajectoire
category_idVoie UUIDRequis

Identification des catégories.

Exemple : 125976d5-c276-481c-984c-a9b4b70e477e
Corps JSON
namechaîneFacultatif

Nom de catégorie unique dans l'espace de travail.

Exemple : Billing
descriptionchaîneFacultatif

Description de la catégorie opérationnelle.

Exemple : Invoice and payment workflows
colorcouleur hexFacultatif

Couleur du tableau de bord.

Exemple : #46769b

Exemple de requête

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

Exemple de réponse

200
{
    "updated": true
}

Réponses possibles

200Demande effectuée avec succès
401Clé API manquante, invalide ou expirée
403Autorisation insuffisante
422La validation de la demande a échoué
Préparer le formulaire de test interactif...
DELETE/categories/{category_id}

Supprimer la catégorie

Supprimer l'élément organisationnel. Les emplois restent disponibles; les relations de groupe supprimées deviennent vides.

AutorisationClé API compatible avec l'écriture

Champs de demande

Paramètres de trajectoire
category_idVoie UUIDRequis

Identification des catégories.

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

Exemple de requête

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

Exemple de réponse

204
No response body

Réponses possibles

204Rubrique supprimée
401Clé API non valide
404Élément non trouvé
Préparer le formulaire de test interactif...
DOMAINE D'API

Événements

Lisez et reconnaissez les échecs qui nécessitent une attention professionnelle.

Allez/incidents

Liste des incidents

Retour à 500 incidents ordonnés par heure d'ouverture. Les réponses contiennent un historique opérationnel ouvert, reconnu et résolu.

AutorisationToute clé API

Exemple de requête

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

Exemple de réponse

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

Réponses possibles

200Demande effectuée avec succès
401Clé API manquante, invalide ou expirée
403Autorisation insuffisante
422La validation de la demande a échoué
Préparer le formulaire de test interactif...
POSTE/incidents/{incident_id}/acknowledge

Reconnaître un incident

Marquer un incident ouvert tel qu'il est reconnu et consigner l'heure exacte de reconnaissance UTC.

AutorisationClé API compatible avec l'écriture

Champs de demande

Paramètres de trajectoire
incident_idchemin entierRequis

Identificateur d'incident.

Exemple : 731

Exemple de requête

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

Exemple de réponse

200
{
    "acknowledged": true
}

Réponses possibles

200Demande effectuée avec succès
401Clé API manquante, invalide ou expirée
403Autorisation insuffisante
422La validation de la demande a échoué
Préparer le formulaire de test interactif...