CronLume
CRONLUME PROFESSIONAL API · V1

Aufbau, Betrieb und Wiederherstellung
Jeder Cron nach API.

Vollständige Referenz- und Live-Testkonsole für professionelle Cron-Operationen. Verbinden Sie einen dedizierten API-Schlüssel, bearbeiten Sie reale Parameter und überprüfen Sie die genaue Antwort, die von Ihrem CronLume-Arbeitsbereich zurückgegeben wird.

25 dokumentierte VorgängeJSON Ersuchende und AntwortstellenTräger Authentifizierung
URL DER PRODUKTIONSGRUNDLAGEhttps://api.cronlume.com/v1AUTHENTIZIERUNGSHEADERAuthorization: Bearer crl_live_…

Schlüssel werden erstellt und widerrufen unter Dashboard → API Keys.

LIVE API CONSOLE

Verbinden Sie Ihren API Key

Der Schlüssel bleibt im Speicher dieser Seite und wird nur an den Endpunkt gesendet, den Sie explizit testen. Es wird niemals zu Beispielen, URLs oder Browserspeicher hinzugefügt.

nicht angeschlossen
API DOMAIN

Authentifizierung

Überprüfen Sie die Anmeldeinformationen und identifizieren Sie den aktiven Arbeitsbereich.

ET/account

API-Verbindung überprüfen

Validieren Sie den Bearer-Schlüssel und geben Sie die authentifizierte API-Schlüsselidentität und den Arbeitsbereich zurück. Die interaktive Konsole verwendet diesen Endpunkt, wenn Connect ausgewählt ist.

GenehmigungJeder aktive API Key

Beispielantrag

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

Beispielantwort

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

Mögliche Antworten

200Anfrage erfolgreich abgeschlossen
401Fehlender, ungültiger oder abgelaufener API-Schlüssel
403Unzureichende Genehmigung
422Antragsvalidierung fehlgeschlagen
Vorbereitung des interaktiven Testformulars...
API DOMAIN

Cron Jobs

Erstellen, Überprüfen, Planen und Steuern von HTTP-Cron-Operationen.

ET/crons

Liste und Suche Cron Jobs

Gibt Jobs zurück, die nach operativer Dringlichkeit bestellt wurden. Kombinieren Sie Filter, um ein Projekt, einen Incident-Status oder einen Endpunkt schnell zu finden.

GenehmigungJeder API Key

Anfragefelder

Abfrageparameter
searchStringFakultativ

Suchtitel, URL und Beschreibung.

Beispiel: invoices
statusenumFakultativ

ausstehend, gesund, degradiert, heruntergekommen oder angehalten.

Beispiel: down
activeBooleanFakultativ

Filtern Sie aktive oder deaktivierte Jobs.

Beispiel: true
group_idUUIDFakultativ

Filtern nach Projekt/Site-Gruppe.

category_idUUIDFakultativ

Filter nach Kategorie.

limitGanzzahlFakultativ

Standardmäßig bis 50.

Beispiel: 50
offsetGanzzahlFakultativ

Paginationsversatz. Standard 0.

Beispiel: 0

Beispielantrag

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"

Beispielantwort

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

Mögliche Antworten

200Anfrage erfolgreich abgeschlossen
401Fehlender, ungültiger oder abgelaufener API-Schlüssel
403Unzureichende Genehmigung
422Antragsvalidierung fehlgeschlagen
Vorbereitung des interaktiven Testformulars...
POST/crons

Erstellen Sie einen Cron Job

Erstellen Sie einen vollständig überwachten HTTP-Zeitplan. Erforderliche Felder sind absichtlich minimal; jede Betriebssicherheit kann in derselben Anforderung konfiguriert werden.

GenehmigungSchreibfähige API-Schlüssel

Anfragefelder

JSON-Körper
nameStringerforderlich

Menschenlesbarer Titel, der in Such-, Alarm- und Incident-Timelines verwendet wird.

Beispiel: Generate customer invoices
urlURLerforderlich

HTTP- oder HTTPS-Endpunkt, der vom Ausführungsarbeiter aufgerufen wird. Platzieren Sie niemals Anmeldeinformationen in der URL.

Beispiel: https://billing.example.com/tasks/invoices
cron_expressionStringerforderlich

Standard-Fünffeld-Crontab-Ausdruck: Minute, Stunde, Tag des Monats, Monat und Wochentag.

Beispiel: */15 * * * *
descriptionStringFakultativ

Betriebszweck und sicherer Kontext für Responder. Maximal 600 Zeichen.

Beispiel: Creates invoices for completed billing periods.
criticalityenumFakultativ

Standard, wichtig oder kritisch. Defaults zu wichtig.

Beispiel: critical
methodenumFakultativ

GET, POST, PUT, PATCH, DELETE oder HEAD. Standard für GET.

Beispiel: POST
headersObjektFakultativ

HTTP Request Header. Verschlüsselt gespeichert. Fügen Sie sie nicht in Support-Anfragen ein.

Beispiel: {"Authorization":"Bearer service-token"}
bodyStringFakultativ

Raw HTTP Request Body an den Endpunkt gesendet.

Beispiel: {"source":"cronlume"}
group_idUUID|nullFakultativ

Bestehende Gruppe im selben Arbeitsbereich.

category_idsUUID[]Fakultativ

Bestehende Kategoriebezeichner im selben Arbeitsbereich.

Beispiel: []
timezoneIANA ZeitzoneFakultativ

Zeitzone zur Auswertung der Cron-Expression. Ausfälle bei UTC.

Beispiel: Europe/Brussels
timeout_secondsGanzzahlFakultativ

Maximale Gesamtanforderungsdauer. Langlaufende Endpunkte werden unterstützt. Defaults auf 120.

Beispiel: 180
connect_timeout_secondsGanzzahlFakultativ

Maximale Verbindungsaufbauzeit. Ausfälle bis 15.

Beispiel: 20
follow_redirectsBooleanFakultativ

Folgen Sie HTTP Redirects. Defaults to true.

Beispiel: 1
verify_tlsBooleanFakultativ

Überprüfen Sie das Remote-TLS-Zertifikat. Keep enabled in der Produktion.

Beispiel: 1
expected_status_minGanzzahlFakultativ

Der niedrigste HTTP-Status wird als erfolgreich angesehen. Defaults auf 200.

Beispiel: 200
expected_status_maxGanzzahlFakultativ

Höchster HTTP-Status gilt als erfolgreich. Defaults zu 399.

Beispiel: 399
max_retriesGanzzahlFakultativ

Zusätzliche Versuche nach einer fehlgeschlagenen Anfrage. Ausfälle bis 2.

Beispiel: 2
retry_backoff_secondsGanzzahlFakultativ

Verzögerung zwischen Wiederholungsversuchen. Ausfälle bis 30.

Beispiel: 30
failure_thresholdGanzzahlFakultativ

Aufeinanderfolgende gescheiterte Hinrichtungen, bevor der Job als niedergeschlagen betrachtet wird. Ausfälle bis 2.

Beispiel: 3
recovery_thresholdGanzzahlFakultativ

Aufeinanderfolgende Erfolge sind erforderlich, um einen Vorfall zu lösen. Standardmäßig 1.

Beispiel: 1
alert_repeat_minutesGanzzahlFakultativ

Wiederholen Sie das Intervall für Warnmeldungen bei anhaltenden Störungen. Ausfälle bis 15.

Beispiel: 15
grace_secondsGanzzahlFakultativ

Die Planung der Gnadenfrist vor einem verpassten Lauf wird als verspätet betrachtet. Defaults auf 60.

Beispiel: 60
alert_on_pauseBooleanFakultativ

Senden Sie Benachrichtigungen, wenn der Job automatisch oder manuell deaktiviert wird. Defaults to true.

Beispiel: 1
failure_action_enabledBooleanFakultativ

Rufen Sie eine Notfall-URL auf, wenn der konfigurierte Fehlerstreifen erreicht ist.

Beispiel: 1
failure_action_thresholdGanzzahlFakultativ

Fehlerzähler, der die Notfall-URL auslöst. Bereich 1–20.

Beispiel: 3
failure_action_urlURL|NullFakultativ

Notfall HTTP(S) URL. muss von der primären URL abweichen.

Beispiel: https://backup.example.com/recover/invoices
is_activeBooleanFakultativ

Erstellen Sie den Job aktiv oder pausiert. Defaults to true.

Beispiel: 1

Beispielantrag

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

Beispielantwort

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

Mögliche Antworten

201Cron Job geschaffen
401Ungültiger API Schlüssel
422Fehlendes Feld, ungültiger Cron-Ausdruck oder ungültige Notfall-URL
Vorbereitung des interaktiven Testformulars...
ET/crons/{cron_id}

Einen Cron Job abrufen

Geben Sie die vollständige Konfiguration und den aktuellen Betriebszustand zurück, einschließlich entschlüsselter Request-Header für autorisierte technische Verwendung. Behandle die Antwort als sensibel.

GenehmigungJeder API Key

Anfragefelder

Trassenparameter
cron_idUUID-Pfaderforderlich

Cron Job Identifier.

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

Beispielantrag

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

Beispielantwort

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

Mögliche Antworten

200Cron Job zurückgegeben
401Ungültiger API Schlüssel
404Cron-Job nicht in diesem Arbeitsbereich gefunden
Vorbereitung des interaktiven Testformulars...
PATCH/crons/{cron_id}

Cron-Konfiguration ändern

Aktualisieren Sie ein oder mehrere unterstützte Felder. Ausgelassene Felder behalten ihre aktuellen Werte. Durch Ändern des Zeitplans oder der Zeitzone wird next run at neu berechnet.

GenehmigungSchreibfähige API-Schlüssel

Anfragefelder

Trassenparameter
cron_idUUID-Pfaderforderlich

Cron Job Identifier.

Beispiel: a870d9ac-3a0f-49bb-b8e2-5f392fffc821
JSON-Körper
nameStringFakultativ

Menschenlesbarer Titel, der in Such-, Alarm- und Incident-Timelines verwendet wird.

Beispiel: Generate customer invoices
urlURLFakultativ

HTTP- oder HTTPS-Endpunkt, der vom Ausführungsarbeiter aufgerufen wird. Platzieren Sie niemals Anmeldeinformationen in der URL.

Beispiel: https://billing.example.com/tasks/invoices
cron_expressionStringFakultativ

Standard-Fünffeld-Crontab-Ausdruck: Minute, Stunde, Tag des Monats, Monat und Wochentag.

Beispiel: */15 * * * *
descriptionStringFakultativ

Betriebszweck und sicherer Kontext für Responder. Maximal 600 Zeichen.

Beispiel: Creates invoices for completed billing periods.
criticalityenumFakultativ

Standard, wichtig oder kritisch. Defaults zu wichtig.

Beispiel: critical
methodenumFakultativ

GET, POST, PUT, PATCH, DELETE oder HEAD. Standard für GET.

Beispiel: POST
headersObjektFakultativ

HTTP Request Header. Verschlüsselt gespeichert. Fügen Sie sie nicht in Support-Anfragen ein.

Beispiel: {"Authorization":"Bearer service-token"}
bodyStringFakultativ

Raw HTTP Request Body an den Endpunkt gesendet.

Beispiel: {"source":"cronlume"}
group_idUUID|nullFakultativ

Bestehende Gruppe im selben Arbeitsbereich.

category_idsUUID[]Fakultativ

Bestehende Kategoriebezeichner im selben Arbeitsbereich.

Beispiel: []
timezoneIANA ZeitzoneFakultativ

Zeitzone zur Auswertung der Cron-Expression. Ausfälle bei UTC.

Beispiel: Europe/Brussels
timeout_secondsGanzzahlFakultativ

Maximale Gesamtanforderungsdauer. Langlaufende Endpunkte werden unterstützt. Defaults auf 120.

Beispiel: 180
connect_timeout_secondsGanzzahlFakultativ

Maximale Verbindungsaufbauzeit. Ausfälle bis 15.

Beispiel: 20
follow_redirectsBooleanFakultativ

Folgen Sie HTTP Redirects. Defaults to true.

Beispiel: 1
verify_tlsBooleanFakultativ

Überprüfen Sie das Remote-TLS-Zertifikat. Keep enabled in der Produktion.

Beispiel: 1
expected_status_minGanzzahlFakultativ

Der niedrigste HTTP-Status wird als erfolgreich angesehen. Defaults auf 200.

Beispiel: 200
expected_status_maxGanzzahlFakultativ

Höchster HTTP-Status gilt als erfolgreich. Defaults zu 399.

Beispiel: 399
max_retriesGanzzahlFakultativ

Zusätzliche Versuche nach einer fehlgeschlagenen Anfrage. Ausfälle bis 2.

Beispiel: 2
retry_backoff_secondsGanzzahlFakultativ

Verzögerung zwischen Wiederholungsversuchen. Ausfälle bis 30.

Beispiel: 30
failure_thresholdGanzzahlFakultativ

Aufeinanderfolgende gescheiterte Hinrichtungen, bevor der Job als niedergeschlagen betrachtet wird. Ausfälle bis 2.

Beispiel: 3
recovery_thresholdGanzzahlFakultativ

Aufeinanderfolgende Erfolge sind erforderlich, um einen Vorfall zu lösen. Standardmäßig 1.

Beispiel: 1
alert_repeat_minutesGanzzahlFakultativ

Wiederholen Sie das Intervall für Warnmeldungen bei anhaltenden Störungen. Ausfälle bis 15.

Beispiel: 15
grace_secondsGanzzahlFakultativ

Die Planung der Gnadenfrist vor einem verpassten Lauf wird als verspätet betrachtet. Defaults auf 60.

Beispiel: 60
alert_on_pauseBooleanFakultativ

Senden Sie Benachrichtigungen, wenn der Job automatisch oder manuell deaktiviert wird. Defaults to true.

Beispiel: 1
failure_action_enabledBooleanFakultativ

Rufen Sie eine Notfall-URL auf, wenn der konfigurierte Fehlerstreifen erreicht ist.

Beispiel: 1
failure_action_thresholdGanzzahlFakultativ

Fehlerzähler, der die Notfall-URL auslöst. Bereich 1–20.

Beispiel: 3
failure_action_urlURL|NullFakultativ

Notfall HTTP(S) URL. muss von der primären URL abweichen.

Beispiel: https://backup.example.com/recover/invoices
is_activeBooleanFakultativ

Erstellen Sie den Job aktiv oder pausiert. Defaults to true.

Beispiel: 1

Beispielantrag

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

Beispielantwort

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

Mögliche Antworten

200Anfrage erfolgreich abgeschlossen
401Fehlender, ungültiger oder abgelaufener API-Schlüssel
403Unzureichende Genehmigung
422Antragsvalidierung fehlgeschlagen
Vorbereitung des interaktiven Testformulars...
DELEKT/crons/{cron_id}

Einen Cron-Job dauerhaft löschen

Löschen Sie den Job und seine Ausführung Geschichte. Diese Operation ist dauerhaft und gibt keinen Antwortkörper zurück.

GenehmigungSchreibfähige API-Schlüssel

Anfragefelder

Trassenparameter
cron_idUUID-Pfaderforderlich

Cron Job Identifier.

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

Beispielantrag

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

Beispielantwort

204
No response body

Mögliche Antworten

204Cron Job und verwandte Geschichte gelöscht
401Ungültiger API Schlüssel
404Cron Job nicht gefunden
Vorbereitung des interaktiven Testformulars...
POST/crons/{cron_id}/activate

Aktivieren oder Reaktivieren eines Crons

Löscht das Pausendatum und den Grund, setzt Sperren zurück und berechnet die nächste Ausführung.

GenehmigungSchreibfähige API-Schlüssel

Anfragefelder

Trassenparameter
cron_idUUID-Pfaderforderlich

Cron Job Identifier.

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

Beispielantrag

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"

Beispielantwort

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

Mögliche Antworten

200Cron State geändert
401Ungültiger API Schlüssel
404Cron Job nicht gefunden
Vorbereitung des interaktiven Testformulars...
POST/crons/{cron_id}/deactivate

Einen Cron deaktivieren

Stoppt zukünftige Ausführung und zeichnet den genauen UTC-Pause-Zeitstempel und den API-Grund auf.

GenehmigungSchreibfähige API-Schlüssel

Anfragefelder

Trassenparameter
cron_idUUID-Pfaderforderlich

Cron Job Identifier.

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

Beispielantrag

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"

Beispielantwort

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

Mögliche Antworten

200Cron State geändert
401Ungültiger API Schlüssel
404Cron Job nicht gefunden
Vorbereitung des interaktiven Testformulars...
POST/crons/{cron_id}/run

Warteschlange zur sofortigen Ausführung

Verschiebet next run at zur aktuellen UTC-Zeit. Der Scheduler nimmt den Job asynchron an.

GenehmigungSchreibfähige API-Schlüssel

Anfragefelder

Trassenparameter
cron_idUUID-Pfaderforderlich

Cron Job Identifier.

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

Beispielantrag

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"

Beispielantwort

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

Mögliche Antworten

202Hinrichtungswarteschlange
409Cron ist inaktiv; reaktivieren Sie es zuerst
401Ungültiger API Schlüssel
404Cron Job nicht gefunden
Vorbereitung des interaktiven Testformulars...
POST/crons/bulk-activate

Mehrere Cron Jobs reaktivieren

Reaktivieren Sie ausgewählte deaktivierte Jobs nach einem Serverausfall oder einem behobenen Vorfall. Unbekannte oder bereits aktive Identifikatoren werden ignoriert.

GenehmigungSchreibfähige API-Schlüssel

Anfragefelder

JSON-Körper
job_idsUUID[]erforderlich

Eindeutige Cron-Identifikatoren zur Reaktivierung. Empfohlene maximale Charge: 200.

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

Beispielantrag

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

Beispielantwort

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

Mögliche Antworten

200Anfrage erfolgreich abgeschlossen
401Fehlender, ungültiger oder abgelaufener API-Schlüssel
403Unzureichende Genehmigung
422Antragsvalidierung fehlgeschlagen
Vorbereitung des interaktiven Testformulars...
POST/crons/{cron_id}/duplicate

Duplizieren Sie einen Cron sicher

Erstellen Sie eine genaue operative Kopie, einschließlich Kategorien, Warnkanäle, verschlüsselte Header und Request Body. Die Kopie wird immer angehalten und eindeutig benannt, so dass sie vor der Aktivierung überprüft werden kann, ohne eine doppelte Ausführung zu verursachen.

GenehmigungSchreibfähige API-Schlüssel

Anfragefelder

Trassenparameter
cron_idUUID-Pfaderforderlich

Quelle cron job identifier.

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

Beispielantrag

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"

Beispielantwort

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

Mögliche Antworten

201Angehaltenes Duplikat erstellt
401Ungültiger API Schlüssel
404Quelle Cron Job nicht gefunden
Vorbereitung des interaktiven Testformulars...
POST/crons/bulk-pause

Mehrere Cron Jobs pausieren

Unterbrechen Sie bis zu 200 aktive Jobs in einem Vorgang. CronLume zeichnet die genaue UTC-Pausezeit und einen Entwickler-API-Grund für jeden betroffenen Job auf. Unbekannte, unzugängliche und bereits angehaltene Identifikatoren werden als ignoriert gemeldet.

GenehmigungSchreibfähige API-Schlüssel

Anfragefelder

JSON-Körper
job_idsUUID[]erforderlich

Eindeutige Cron-Identifikatoren zum Anhalten. Maximal 200.

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

Beispielantrag

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

Beispielantwort

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

Mögliche Antworten

200Anfrage erfolgreich abgeschlossen
401Fehlender, ungültiger oder abgelaufener API-Schlüssel
403Unzureichende Genehmigung
422Antragsvalidierung fehlgeschlagen
Vorbereitung des interaktiven Testformulars...
POST/crons/bulk-move

Verschieben Sie mehrere Cron-Jobs in eine Gruppe

Verschieben Sie bis zu 200 Jobs in ein Projekt, eine Website, einen Service oder eine Kundengruppe. Senden Sie group id als null, um die ausgewählten Jobs ungrouped zu machen. Es können nur Jobs und Gruppen aus dem authentifizierten Arbeitsbereich verwendet werden.

GenehmigungSchreibfähige API-Schlüssel

Anfragefelder

JSON-Körper
job_idsUUID[]erforderlich

Eindeutige Cron-Identifikatoren zu bewegen. Maximal 200.

Beispiel: ["a870d9ac-3a0f-49bb-b8e2-5f392fffc821"]
group_idUUID|nullerforderlich

Zielgruppenkennung oder null für Ungrouped.

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

Beispielantrag

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

Beispielantwort

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

Mögliche Antworten

200Anfrage erfolgreich abgeschlossen
401Fehlender, ungültiger oder abgelaufener API-Schlüssel
403Unzureichende Genehmigung
422Antragsvalidierung fehlgeschlagen
Vorbereitung des interaktiven Testformulars...
API DOMAIN

Hinrichtungen

Untersuchen Sie Timing, HTTP-Ergebnisse, Wiederholungen und Notfallaktionen.

ET/crons/{cron_id}/executions

Ausführungsverlauf der Liste

Überprüfen Sie die Reaktionszeit, den HTTP-Status, Wiederholungen und sichere Antwortnachweise für einen einzelnen Cron. Die letzte Ausführung wird zuerst zurückgegeben.

GenehmigungJeder API Key

Anfragefelder

Trassenparameter
cron_idUUID-Pfaderforderlich

Cron Job Identifier.

Beispiel: a870d9ac-3a0f-49bb-b8e2-5f392fffc821
Abfrageparameter
limitGanzzahlFakultativ

1–200. Standardmäßig bis 50.

Beispiel: 50

Beispielantrag

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"

Beispielantwort

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

Mögliche Antworten

200Anfrage erfolgreich abgeschlossen
401Fehlender, ungültiger oder abgelaufener API-Schlüssel
403Unzureichende Genehmigung
422Antragsvalidierung fehlgeschlagen
Vorbereitung des interaktiven Testformulars...
ET/crons/{cron_id}/failure-actions

Notausführungen auflisten

Überprüfen Sie jede Wiederherstellungs-URL-Aufrufung, die durch eine Regel des fortlaufenden Fehlers ausgelöst wird.

GenehmigungJeder API Key

Anfragefelder

Trassenparameter
cron_idUUID-Pfaderforderlich

Cron Job Identifier.

Beispiel: a870d9ac-3a0f-49bb-b8e2-5f392fffc821
Abfrageparameter
limitGanzzahlFakultativ

1–200. Standardmäßig bis 50.

Beispiel: 50

Beispielantrag

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"

Beispielantwort

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

Mögliche Antworten

200Anfrage erfolgreich abgeschlossen
401Fehlender, ungültiger oder abgelaufener API-Schlüssel
403Unzureichende Genehmigung
422Antragsvalidierung fehlgeschlagen
Vorbereitung des interaktiven Testformulars...
API DOMAIN

Organisation

Strukturieren Sie Flotten nach Projekt, Website, Service, Kunden- und Betriebskategorie.

ET/groups

Listengruppen

Geben Sie jedes Projekt, jede Website, jeden Dienst oder jede andere Konfiguration im authentifizierten Arbeitsbereich zurück.

GenehmigungJeder API Key

Beispielantrag

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

Beispielantwort

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

Mögliche Antworten

200Anfrage erfolgreich abgeschlossen
401Fehlender, ungültiger oder abgelaufener API-Schlüssel
403Unzureichende Genehmigung
422Antragsvalidierung fehlgeschlagen
Vorbereitung des interaktiven Testformulars...
POST/groups

Gruppen erstellen

Erstellen Sie ein wiederverwendbares Projekt, eine Website, einen Service oder eine andere, um die Cron-Flotte zu organisieren.

GenehmigungSchreibfähige API-Schlüssel

Anfragefelder

JSON-Körper
nameStringerforderlich

Eindeutiger Gruppenname im Workspace.

Beispiel: Billing platform
group_typeenumFakultativ

Projekt, Website, Service oder anderes.

Beispiel: service
client_referencestring|nullFakultativ

Kunden, Vertrag oder interne Referenz. Maximal 160 Zeichen.

Beispiel: CLIENT-ACME-0042
descriptionstring|nullFakultativ

Zweck und Eigentümerkontext.

Beispiel: Customer billing automation
colorHexfarbeFakultativ

Dashboard Display Farbe.

Beispiel: #147d64

Beispielantrag

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

Beispielantwort

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

Mögliche Antworten

201Gruppen geschaffen
401Ungültiger API Schlüssel
422Ungültige oder doppelte Werte
Vorbereitung des interaktiven Testformulars...
PATCH/groups/{group_id}

Aktualisierungsgruppe

Ändern Sie ein oder mehrere Felder. Ausgelassene Felder bleiben unverändert.

GenehmigungSchreibfähige API-Schlüssel

Anfragefelder

Trassenparameter
group_idUUID-Pfaderforderlich

Gruppenkennung.

Beispiel: 6ef63789-baf1-44fc-99bb-0c5ce2d37a8b
JSON-Körper
nameStringFakultativ

Eindeutiger Gruppenname im Workspace.

Beispiel: Billing platform
group_typeenumFakultativ

Projekt, Website, Service oder anderes.

Beispiel: service
client_referencestring|nullFakultativ

Kunden, Vertrag oder interne Referenz. Maximal 160 Zeichen.

Beispiel: CLIENT-ACME-0042
descriptionstring|nullFakultativ

Zweck und Eigentümerkontext.

Beispiel: Customer billing automation
colorHexfarbeFakultativ

Dashboard Display Farbe.

Beispiel: #147d64

Beispielantrag

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

Beispielantwort

200
{
    "updated": true
}

Mögliche Antworten

200Anfrage erfolgreich abgeschlossen
401Fehlender, ungültiger oder abgelaufener API-Schlüssel
403Unzureichende Genehmigung
422Antragsvalidierung fehlgeschlagen
Vorbereitung des interaktiven Testformulars...
DELEKT/groups/{group_id}

Gruppe löschen

Das organisatorische Element ist zu streichen. Jobs bleiben verfügbar; gelöschte Gruppenbeziehungen werden leer.

GenehmigungSchreibfähige API-Schlüssel

Anfragefelder

Trassenparameter
group_idUUID-Pfaderforderlich

Gruppenkennung.

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

Beispielantrag

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

Beispielantwort

204
No response body

Mögliche Antworten

204Gruppenposition gelöscht
401Ungültiger API Schlüssel
404Nicht gefunden
Vorbereitung des interaktiven Testformulars...
ET/categories

Listenkategorien

Geben Sie jede Betriebskategorie zurück, die im authentifizierten Arbeitsbereich konfiguriert ist.

GenehmigungJeder API Key

Beispielantrag

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

Beispielantwort

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

Mögliche Antworten

200Anfrage erfolgreich abgeschlossen
401Fehlender, ungültiger oder abgelaufener API-Schlüssel
403Unzureichende Genehmigung
422Antragsvalidierung fehlgeschlagen
Vorbereitung des interaktiven Testformulars...
POST/categories

Kategorie erstellen

Erstellen Sie eine wiederverwendbare Betriebskategorie für die Organisation der Cron-Flotte.

GenehmigungSchreibfähige API-Schlüssel

Anfragefelder

JSON-Körper
nameStringerforderlich

Eindeutiger Kategoriename im Workspace.

Beispiel: Billing
descriptionstring|nullFakultativ

Beschreibung der Betriebskategorie.

Beispiel: Invoice and payment workflows
colorHexfarbeFakultativ

Dashboard Display Farbe.

Beispiel: #46769b

Beispielantrag

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

Beispielantwort

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

Mögliche Antworten

201Geschaffene Kategorien
401Ungültiger API Schlüssel
422Ungültige oder doppelte Werte
Vorbereitung des interaktiven Testformulars...
PATCH/categories/{category_id}

Aktualisierungskategorie

Ändern Sie ein oder mehrere Felder. Ausgelassene Felder bleiben unverändert.

GenehmigungSchreibfähige API-Schlüssel

Anfragefelder

Trassenparameter
category_idUUID-Pfaderforderlich

Kennung der Kategorien.

Beispiel: 125976d5-c276-481c-984c-a9b4b70e477e
JSON-Körper
nameStringFakultativ

Eindeutiger Kategoriename im Workspace.

Beispiel: Billing
descriptionstring|nullFakultativ

Beschreibung der Betriebskategorie.

Beispiel: Invoice and payment workflows
colorHexfarbeFakultativ

Dashboard Display Farbe.

Beispiel: #46769b

Beispielantrag

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

Beispielantwort

200
{
    "updated": true
}

Mögliche Antworten

200Anfrage erfolgreich abgeschlossen
401Fehlender, ungültiger oder abgelaufener API-Schlüssel
403Unzureichende Genehmigung
422Antragsvalidierung fehlgeschlagen
Vorbereitung des interaktiven Testformulars...
DELEKT/categories/{category_id}

Kategorie streichen

Das organisatorische Element ist zu streichen. Jobs bleiben verfügbar; gelöschte Gruppenbeziehungen werden leer.

GenehmigungSchreibfähige API-Schlüssel

Anfragefelder

Trassenparameter
category_idUUID-Pfaderforderlich

Kennung der Kategorien.

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

Beispielantrag

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

Beispielantwort

204
No response body

Mögliche Antworten

204Kategorieposition gestrichen
401Ungültiger API Schlüssel
404Nicht gefunden
Vorbereitung des interaktiven Testformulars...
API DOMAIN

Vorfälle

Lesen und erkennen Sie Fehler an, die professionelle Aufmerksamkeit erfordern.

ET/incidents

Liste der Vorfälle

Geben Sie bis zu 500 Vorfälle zurück, die nach Öffnungszeit bestellt wurden. Die Antworten enthalten eine offene, anerkannte und gelöste Betriebsgeschichte.

GenehmigungJeder API Key

Beispielantrag

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

Beispielantwort

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

Mögliche Antworten

200Anfrage erfolgreich abgeschlossen
401Fehlender, ungültiger oder abgelaufener API-Schlüssel
403Unzureichende Genehmigung
422Antragsvalidierung fehlgeschlagen
Vorbereitung des interaktiven Testformulars...
POST/incidents/{incident_id}/acknowledge

Einen Vorfall bestätigen

Markieren Sie einen offenen Vorfall als bestätigt und notieren Sie die genaue UTC-Bestätigungszeit.

GenehmigungSchreibfähige API-Schlüssel

Anfragefelder

Trassenparameter
incident_idGanzzahliger Pfaderforderlich

Ereigniskennung.

Beispiel: 731

Beispielantrag

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

Beispielantwort

200
{
    "acknowledged": true
}

Mögliche Antworten

200Anfrage erfolgreich abgeschlossen
401Fehlender, ungültiger oder abgelaufener API-Schlüssel
403Unzureichende Genehmigung
422Antragsvalidierung fehlgeschlagen
Vorbereitung des interaktiven Testformulars...