CRONLUME PROFESSIONAL API · V1

Bouwen, werken en herstellen
Elke cron door API.

Complete referentie en live testconsole voor professionele cron operaties. Sluit een speciale API-sleutel aan, bewerk echte parameters en inspecteer de exacte reactie die uw CronLume-werkruimte teruggeeft.

25 Gedocumenteerde bewerkingenJSON verzoeken- en reactieorganenDraager authenticatie

PRODUCTIEBASE URLhttps://api.cronlume.com/v1AuthenticatiekopAuthorization: Bearer crl_live_…

Sleutels worden aangemaakt en ingetrokken onder Dashboard → API sleutels.

⌁

LEVENDE API-CONSOOL

Sluit uw API-sleutel aan

De sleutel blijft in het geheugen van deze pagina en wordt alleen verzonden naar het eindpunt dat u expliciet test. Het wordt nooit toegevoegd aan voorbeelden, URL's of browseropslag.

CronLume API sleutel

Niet verbonden

API DOMAIN

Aanmeldingscontrole

Verifiëren van referenties en identificeren van de actieve werkruimte.

Get/account

API-verbinding verifiëren

Valideer de Bearer-sleutel en geef de geauthentificeerde API-sleutel identiteit en werkruimte terug. De interactieve console gebruikt dit eindpunt wanneer Connect wordt geselecteerd.

ToestemmingAlle actieve API-sleutels

Voorbeeldverzoek

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

Voorbeeldantwoord

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

Mogelijke reacties

200Verzoek succesvol voltooid

401Ontbrekende, ongeldige of verlopen API-sleutel

403Onvoldoende toestemming

422Verzoekvalidering mislukt

Voorbereiding van het interactieve testformulier...

API DOMAIN

Cron jobs

Aanmaken, inspecteren, plannen en beheren van HTTP cron operaties.

Get/crons

Lijst en zoekopdracht cron jobs

Geeft opdrachten terug die met operationele urgentie zijn besteld. Combineer filters om snel een project, incidenttoestand of eindpunt te vinden.

ToestemmingElke API-sleutel

Verzoekvelden

Zoekparameters

searchtekenreeksFacultatief

Zoek titel, URL en beschrijving.

Voorbeeld: invoices

statusenumFacultatief

in afwachting, gezond, gedegradeerd, naar beneden of gepauzeerd.

Voorbeeld: down

activebooleaansFacultatief

Filter actieve of uitgeschakelde taken.

Voorbeeld: true

group_idUUIDFacultatief

Filteren op project/site groep.

category_idUUIDFacultatief

Filter op categorie.

limitgeheel getalFacultatief

Standaard tot 50.

Voorbeeld: 50

offsetgeheel getalFacultatief

Paginatie offset. Standaardwaarden voor 0.

Voorbeeld: 0

Voorbeeldverzoek

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"

Voorbeeldantwoord

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

Mogelijke reacties

200Verzoek succesvol voltooid

401Ontbrekende, ongeldige of verlopen API-sleutel

403Onvoldoende toestemming

422Verzoekvalidering mislukt

Voorbereiding van het interactieve testformulier...

POST/crons

Een cron-taak aanmaken

Maak een volledig bewaakt HTTP-schema aan. Vereiste velden zijn opzettelijk minimaal; elke operationele beveiliging kan in hetzelfde verzoek worden geconfigureerd.

ToestemmingAPI-sleutel met schrijffunctie

Verzoekvelden

JSON lichaam

nametekenreeksVereist

Menselijk leesbare titel gebruikt in zoek-, alarm- en incidenttijdlijnen.

Voorbeeld: Generate customer invoices

urlURLVereist

HTTP of HTTPS eindpunt gebeld door de uitvoerder. Plaats nooit referenties in de URL.

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

cron_expressiontekenreeksVereist

Standaard vijf-veld crontab uitdrukking: minuut, uur, dag van de maand, maand en dag van de week.

Voorbeeld: */15 * * * *

descriptiontekenreeksFacultatief

Operationele doelstelling en veilige context voor responders. Maximaal 600 tekens.

Voorbeeld: Creates invoices for completed billing periods.

criticalityenumFacultatief

standaard, belangrijk of kritisch. Standaardwaarden voor belangrijk.

Voorbeeld: critical

methodenumFacultatief

Get, post, put, patch, Delete of head. Standaardwaarden voor GET.

Voorbeeld: POST

headersobjectFacultatief

HTTP-verzoek headers. Versleuteld opgeslagen. Neem ze niet op in ondersteuningsverzoeken.

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

bodytekenreeksFacultatief

Raw HTTP verzoek lichaam verzonden naar het eindpunt.

Voorbeeld: {"source":"cronlume"}

group_idUUIDFacultatief

Bestaande groep in dezelfde werkruimte.

category_idsUUID[]Facultatief

Bestaande categorie-identificatienummers in dezelfde werkruimte.

Voorbeeld: []

timezoneIANA-tijdzoneFacultatief

Tijdzone gebruikt om de cron expressie te evalueren. Standaardwaarden voor UTC.

Voorbeeld: Europe/Brussels

timeout_secondsgeheel getalFacultatief

Maximale totale aanvraagduur. Langlopende eindpunten worden ondersteund. Standaard naar 120.

Voorbeeld: 180

connect_timeout_secondsgeheel getalFacultatief

Maximale verbindingstijd. Standaard naar 15.

Voorbeeld: 20

follow_redirectsbooleaansFacultatief

Volg HTTP omleidingen. Standaardwaarden voor waar.

Voorbeeld: 1

verify_tlsbooleaansFacultatief

Controleer het TLS-certificaat op afstand. Blijf in productie.

Voorbeeld: 1

expected_status_mingeheel getalFacultatief

Laagste HTTP status als succesvol beschouwd. Standaard naar 200.

Voorbeeld: 200

expected_status_maxgeheel getalFacultatief

Hoogste HTTP status als succesvol beschouwd. Standaard naar 399.

Voorbeeld: 399

max_retriesgeheel getalFacultatief

Extra pogingen na een mislukt verzoek. Standaard naar 2.

Voorbeeld: 2

retry_backoff_secondsgeheel getalFacultatief

Vertraging tussen de pogingen. Standaardwaarden tot 30.

Voorbeeld: 30

failure_thresholdgeheel getalFacultatief

Consecutieve mislukte executies voordat de taak wordt beschouwd als neer. Standaard naar 2.

Voorbeeld: 3

recovery_thresholdgeheel getalFacultatief

Consecutieve successen die nodig zijn om een incident op te lossen. Standaardwaarden voor 1.

Voorbeeld: 1

alert_repeat_minutesgeheel getalFacultatief

Herhaal interval voor aanhoudende incidentenmeldingen. Standaard naar 15.

Voorbeeld: 15

grace_secondsgeheel getalFacultatief

Scheduling grace periode voordat een gemiste run wordt beschouwd als laat. Standaard naar 60.

Voorbeeld: 60

alert_on_pausebooleaansFacultatief

Waarschuwingen verzenden wanneer de opdracht automatisch of handmatig uitgeschakeld is. Standaardwaarden voor waar.

Voorbeeld: 1

failure_action_enabledbooleaansFacultatief

Bel een noodURL als de ingestelde foutstreak is bereikt.

Voorbeeld: 1

failure_action_thresholdgeheel getalFacultatief

Fouten tellen die de noodURL activeert. Afstand 1:20.

Voorbeeld: 3

failure_action_urlURL-nummerFacultatief

Nood HTTP(S) URL. Moet afwijken van de primaire URL.

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

is_activebooleaansFacultatief

Maak de taak actief of gepauzeerd. Standaardwaarden voor waar.

Voorbeeld: 1

Voorbeeldverzoek

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

Voorbeeldantwoord

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

Mogelijke reacties

201Cron-job aangemaakt

401Ongeldige API-sleutel

422Ontbrekend veld, ongeldige cron-expressie of ongeldige noodURL

Voorbereiding van het interactieve testformulier...

Get/crons/{cron_id}

Een cron job ophalen

Geef volledige configuratie en huidige operationele status terug, inclusief gedecodeerde verzoekkoppen voor toegestaan technisch gebruik. Behandel de reactie als gevoelig.

ToestemmingElke API-sleutel

Verzoekvelden

Padparameters

cron_idUUID-padVereist

Cron job identifier.

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

Voorbeeldverzoek

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

Voorbeeldantwoord

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

Mogelijke reacties

200Cron baan terug

401Ongeldige API-sleutel

404Cron-taak niet gevonden in deze werkruimte

Voorbereiding van het interactieve testformulier...

PATCH/crons/{cron_id}

Cron-configuratie wijzigen

Een of meer ondersteunde velden bijwerken. Toegestaane velden behouden hun huidige waarden. Het wijzigen van schema of tijdzone herberekent next run at.

ToestemmingAPI-sleutel met schrijffunctie

Verzoekvelden

Padparameters

cron_idUUID-padVereist

Cron job identifier.

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

JSON lichaam

nametekenreeksFacultatief

Menselijk leesbare titel gebruikt in zoek-, alarm- en incidenttijdlijnen.

Voorbeeld: Generate customer invoices

urlURLFacultatief

HTTP of HTTPS eindpunt gebeld door de uitvoerder. Plaats nooit referenties in de URL.

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

cron_expressiontekenreeksFacultatief

Standaard vijf-veld crontab uitdrukking: minuut, uur, dag van de maand, maand en dag van de week.

Voorbeeld: */15 * * * *

descriptiontekenreeksFacultatief

Operationele doelstelling en veilige context voor responders. Maximaal 600 tekens.

Voorbeeld: Creates invoices for completed billing periods.

criticalityenumFacultatief

standaard, belangrijk of kritisch. Standaardwaarden voor belangrijk.

Voorbeeld: critical

methodenumFacultatief

Get, post, put, patch, Delete of head. Standaardwaarden voor GET.

Voorbeeld: POST

headersobjectFacultatief

HTTP-verzoek headers. Versleuteld opgeslagen. Neem ze niet op in ondersteuningsverzoeken.

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

bodytekenreeksFacultatief

Raw HTTP verzoek lichaam verzonden naar het eindpunt.

Voorbeeld: {"source":"cronlume"}

group_idUUIDFacultatief

Bestaande groep in dezelfde werkruimte.

category_idsUUID[]Facultatief

Bestaande categorie-identificatienummers in dezelfde werkruimte.

Voorbeeld: []

timezoneIANA-tijdzoneFacultatief

Tijdzone gebruikt om de cron expressie te evalueren. Standaardwaarden voor UTC.

Voorbeeld: Europe/Brussels

timeout_secondsgeheel getalFacultatief

Maximale totale aanvraagduur. Langlopende eindpunten worden ondersteund. Standaard naar 120.

Voorbeeld: 180

connect_timeout_secondsgeheel getalFacultatief

Maximale verbindingstijd. Standaard naar 15.

Voorbeeld: 20

follow_redirectsbooleaansFacultatief

Volg HTTP omleidingen. Standaardwaarden voor waar.

Voorbeeld: 1

verify_tlsbooleaansFacultatief

Controleer het TLS-certificaat op afstand. Blijf in productie.

Voorbeeld: 1

expected_status_mingeheel getalFacultatief

Laagste HTTP status als succesvol beschouwd. Standaard naar 200.

Voorbeeld: 200

expected_status_maxgeheel getalFacultatief

Hoogste HTTP status als succesvol beschouwd. Standaard naar 399.

Voorbeeld: 399

max_retriesgeheel getalFacultatief

Extra pogingen na een mislukt verzoek. Standaard naar 2.

Voorbeeld: 2

retry_backoff_secondsgeheel getalFacultatief

Vertraging tussen de pogingen. Standaardwaarden tot 30.

Voorbeeld: 30

failure_thresholdgeheel getalFacultatief

Consecutieve mislukte executies voordat de taak wordt beschouwd als neer. Standaard naar 2.

Voorbeeld: 3

recovery_thresholdgeheel getalFacultatief

Consecutieve successen die nodig zijn om een incident op te lossen. Standaardwaarden voor 1.

Voorbeeld: 1

alert_repeat_minutesgeheel getalFacultatief

Herhaal interval voor aanhoudende incidentenmeldingen. Standaard naar 15.

Voorbeeld: 15

grace_secondsgeheel getalFacultatief

Scheduling grace periode voordat een gemiste run wordt beschouwd als laat. Standaard naar 60.

Voorbeeld: 60

alert_on_pausebooleaansFacultatief

Waarschuwingen verzenden wanneer de opdracht automatisch of handmatig uitgeschakeld is. Standaardwaarden voor waar.

Voorbeeld: 1

failure_action_enabledbooleaansFacultatief

Bel een noodURL als de ingestelde foutstreak is bereikt.

Voorbeeld: 1

failure_action_thresholdgeheel getalFacultatief

Fouten tellen die de noodURL activeert. Afstand 1:20.

Voorbeeld: 3

failure_action_urlURL-nummerFacultatief

Nood HTTP(S) URL. Moet afwijken van de primaire URL.

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

is_activebooleaansFacultatief

Maak de taak actief of gepauzeerd. Standaardwaarden voor waar.

Voorbeeld: 1

Voorbeeldverzoek

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

Voorbeeldantwoord

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

Mogelijke reacties

200Verzoek succesvol voltooid

401Ontbrekende, ongeldige of verlopen API-sleutel

403Onvoldoende toestemming

422Verzoekvalidering mislukt

Voorbereiding van het interactieve testformulier...

DELETE/crons/{cron_id}

Een cron-taak definitief verwijderen

Verwijder de taak en de uitvoeringsgeschiedenis. Deze operatie is permanent en geeft geen reactieorgaan terug.

ToestemmingAPI-sleutel met schrijffunctie

Verzoekvelden

Padparameters

cron_idUUID-padVereist

Cron job identifier.

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

Voorbeeldverzoek

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

Voorbeeldantwoord

204

No response body

Mogelijke reacties

204Cron taak en gerelateerde geschiedenis verwijderd

401Ongeldige API-sleutel

404Cron-taak niet gevonden

Voorbereiding van het interactieve testformulier...

POST/crons/{cron_id}/activate

Een cron activeren of activeren

Verwijdert de pauze datum en reden, reset sloten en berekent de volgende uitvoering.

ToestemmingAPI-sleutel met schrijffunctie

Verzoekvelden

Padparameters

cron_idUUID-padVereist

Cron job identifier.

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

Voorbeeldverzoek

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"

Voorbeeldantwoord

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

Mogelijke reacties

200Cron toestand veranderd

401Ongeldige API-sleutel

404Cron-taak niet gevonden

Voorbereiding van het interactieve testformulier...

POST/crons/{cron_id}/deactivate

Een cron uitschakelen

Stopt toekomstige executies en registreert de exacte UTC pauze tijdstempel en API reden.

ToestemmingAPI-sleutel met schrijffunctie

Verzoekvelden

Padparameters

cron_idUUID-padVereist

Cron job identifier.

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

Voorbeeldverzoek

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"

Voorbeeldantwoord

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

Mogelijke reacties

200Cron toestand veranderd

401Ongeldige API-sleutel

404Cron-taak niet gevonden

Voorbereiding van het interactieve testformulier...

POST/crons/{cron_id}/run

Wacht op een onmiddellijke executie

Verplaatst volgende run at naar de huidige UTC-tijd. De scheduler accepteert de taak asynchroon.

ToestemmingAPI-sleutel met schrijffunctie

Verzoekvelden

Padparameters

cron_idUUID-padVereist

Cron job identifier.

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

Voorbeeldverzoek

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"

Voorbeeldantwoord

202

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

Mogelijke reacties

202Uitvoeren in de wachtrij

409Cron is inactief; reactiveer het eerst

401Ongeldige API-sleutel

404Cron-taak niet gevonden

Voorbereiding van het interactieve testformulier...

POST/crons/bulk-activate

Meerdere crontaken opnieuw activeren

Geselecteerde uitgeschakelde taken opnieuw activeren na een serveruitval of incident opgelost. Onbekende of reeds actieve identificatiemiddelen worden genegeerd.

ToestemmingAPI-sleutel met schrijffunctie

Verzoekvelden

JSON lichaam

job_idsUUID[]Vereist

Unieke cron identifiers om te reactiveren. Maximaal aanbevolen partij: 200.

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

Voorbeeldverzoek

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

Voorbeeldantwoord

200

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

Mogelijke reacties

200Verzoek succesvol voltooid

401Ontbrekende, ongeldige of verlopen API-sleutel

403Onvoldoende toestemming

422Verzoekvalidering mislukt

Voorbereiding van het interactieve testformulier...

POST/crons/{cron_id}/duplicate

Dupliceer een cron veilig

Maak een exacte operationele kopie, met inbegrip van categorieën, waarschuwingskanalen, gecodeerde headers en verzoektekst. De kopie wordt altijd gepauzeerd en duidelijk genoemd, zodat het kan worden beoordeeld vóór activering zonder een dubbele uitvoering.

ToestemmingAPI-sleutel met schrijffunctie

Verzoekvelden

Padparameters

cron_idUUID-padVereist

Bron cron taak identificatie.

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

Voorbeeldverzoek

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"

Voorbeeldantwoord

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

Mogelijke reacties

201Gepauzeerd duplicaat aangemaakt

401Ongeldige API-sleutel

404Bron cron-taak niet gevonden

Voorbereiding van het interactieve testformulier...

POST/crons/bulk-pause

Meerdere crontaken pauzeren

Pauzeer tot 200 actieve banen in één operatie. CronLume registreert de exacte UTC pauze tijd en een ontwikkelaar-API reden op elke getroffen baan. Onbekende, ontoegankelijke en reeds gepauzeerde identificatiemiddelen worden gerapporteerd als genegeerd.

ToestemmingAPI-sleutel met schrijffunctie

Verzoekvelden

JSON lichaam

job_idsUUID[]Vereist

Unieke cron identificaties om te pauzeren. Maximaal 200.

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

Voorbeeldverzoek

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

Voorbeeldantwoord

200

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

Mogelijke reacties

200Verzoek succesvol voltooid

401Ontbrekende, ongeldige of verlopen API-sleutel

403Onvoldoende toestemming

422Verzoekvalidering mislukt

Voorbereiding van het interactieve testformulier...

POST/crons/bulk-move

Meerdere crontaken naar een groep verplaatsen

Tot 200 jobs verplaatsen naar een project, website, service of klantengroep. Groeps id versturen als nul om de geselecteerde taken niet gegroepeerd te maken. Alleen taken en groepen uit de geverifieerde werkruimte kunnen worden gebruikt.

ToestemmingAPI-sleutel met schrijffunctie

Verzoekvelden

JSON lichaam

job_idsUUID[]Vereist

Unieke cron identificaties om te verplaatsen. Maximaal 200.

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

group_idUUIDVereist

Doelgroep-identificatiecode, of nul voor niet-gegroepeerd.

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

Voorbeeldverzoek

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

Voorbeeldantwoord

200

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

Mogelijke reacties

200Verzoek succesvol voltooid

401Ontbrekende, ongeldige of verlopen API-sleutel

403Onvoldoende toestemming

422Verzoekvalidering mislukt

Voorbereiding van het interactieve testformulier...

API DOMAIN

Uitvoeringen

Onderzoek timing, HTTP resultaten, herhalingen en noodsituaties.

Get/crons/{cron_id}/executions

Uitvoergeschiedenis tonen

Inspecteer responstijd, HTTP-status, herhalingen en veilig respons bewijs voor een enkele cron. De meest recente executie wordt eerst teruggegeven.

ToestemmingElke API-sleutel

Verzoekvelden

Padparameters

cron_idUUID-padVereist

Cron job identifier.

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

Zoekparameters

limitgeheel getalFacultatief

1200. Standaard 50.

Voorbeeld: 50

Voorbeeldverzoek

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"

Voorbeeldantwoord

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

Mogelijke reacties

200Verzoek succesvol voltooid

401Ontbrekende, ongeldige of verlopen API-sleutel

403Onvoldoende toestemming

422Verzoekvalidering mislukt

Voorbereiding van het interactieve testformulier...

Get/crons/{cron_id}/failure-actions

Lijst van noodacties

Inspecteer elke recovery URL-aanroeping die wordt veroorzaakt door een opeenvolgende foutregel.

ToestemmingElke API-sleutel

Verzoekvelden

Padparameters

cron_idUUID-padVereist

Cron job identifier.

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

Zoekparameters

limitgeheel getalFacultatief

1200. Standaard 50.

Voorbeeld: 50

Voorbeeldverzoek

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"

Voorbeeldantwoord

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

Mogelijke reacties

200Verzoek succesvol voltooid

401Ontbrekende, ongeldige of verlopen API-sleutel

403Onvoldoende toestemming

422Verzoekvalidering mislukt

Voorbereiding van het interactieve testformulier...

API DOMAIN

Organisatie

Structuur vloten per project, website, service, klant en operationele categorie.

Get/groups

Lijstgroepen

Geef elk project, website, service of andere geconfigureerd in de geverifieerde werkruimte terug.

ToestemmingElke API-sleutel

Voorbeeldverzoek

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

Voorbeeldantwoord

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

Mogelijke reacties

200Verzoek succesvol voltooid

401Ontbrekende, ongeldige of verlopen API-sleutel

403Onvoldoende toestemming

422Verzoekvalidering mislukt

Voorbereiding van het interactieve testformulier...

POST/groups

Groep aanmaken

Maak een herbruikbaar project, website, service of andere voor het organiseren van de cron vloot.

ToestemmingAPI-sleutel met schrijffunctie

Verzoekvelden

JSON lichaam

nametekenreeksVereist

Unieke groepsnaam in de werkruimte.

Voorbeeld: Billing platform

group_typeenumFacultatief

project, website, service of andere.

Voorbeeld: service

client_referencetekenreeksFacultatief

Klant, contract of interne referentie. Maximaal 160 karakters.

Voorbeeld: CLIENT-ACME-0042

descriptiontekenreeksFacultatief

Doel en eigendom context.

Voorbeeld: Customer billing automation

colorhex-kleurFacultatief

Dashboard display kleur.

Voorbeeld: #147d64

Voorbeeldverzoek

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

Voorbeeldantwoord

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

Mogelijke reacties

201Aangemaakt

401Ongeldige API-sleutel

422Ongeldige of dubbele waarden

Voorbereiding van het interactieve testformulier...

PATCH/groups/{group_id}

Groep bijwerken

Een of meer velden wijzigen. Toegestaane velden blijven ongewijzigd.

ToestemmingAPI-sleutel met schrijffunctie

Verzoekvelden

Padparameters

group_idUUID-padVereist

Identificatie van de groepen.

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

JSON lichaam

nametekenreeksFacultatief

Unieke groepsnaam in de werkruimte.

Voorbeeld: Billing platform

group_typeenumFacultatief

project, website, service of andere.

Voorbeeld: service

client_referencetekenreeksFacultatief

Klant, contract of interne referentie. Maximaal 160 karakters.

Voorbeeld: CLIENT-ACME-0042

descriptiontekenreeksFacultatief

Doel en eigendom context.

Voorbeeld: Customer billing automation

colorhex-kleurFacultatief

Dashboard display kleur.

Voorbeeld: #147d64

Voorbeeldverzoek

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

Voorbeeldantwoord

200

{
    "updated": true
}

Mogelijke reacties

200Verzoek succesvol voltooid

401Ontbrekende, ongeldige of verlopen API-sleutel

403Onvoldoende toestemming

422Verzoekvalidering mislukt

Voorbereiding van het interactieve testformulier...

DELETE/groups/{group_id}

Groep verwijderen

Verwijder het organisatieonderdeel. Jobs blijven beschikbaar; verwijderde groepsrelaties worden leeg.

ToestemmingAPI-sleutel met schrijffunctie

Verzoekvelden

Padparameters

group_idUUID-padVereist

Identificatie van de groepen.

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

Voorbeeldverzoek

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

Voorbeeldantwoord

204

No response body

Mogelijke reacties

204Groepen verwijderd

401Ongeldige API-sleutel

404Item niet gevonden

Voorbereiding van het interactieve testformulier...

Get/categories

Lijstcategorieën

Geef elke operationele categorie terug die is geconfigureerd in de geverifieerde werkruimte.

ToestemmingElke API-sleutel

Voorbeeldverzoek

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

Voorbeeldantwoord

200

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

Mogelijke reacties

200Verzoek succesvol voltooid

401Ontbrekende, ongeldige of verlopen API-sleutel

403Onvoldoende toestemming

422Verzoekvalidering mislukt

POST/categories

Categorie aanmaken

Maak een herbruikbare operationele categorie voor het organiseren van de cron vloot.

ToestemmingAPI-sleutel met schrijffunctie

Verzoekvelden

JSON lichaam

nametekenreeksVereist

Unieke categorienaam in de werkruimte.

Voorbeeld: Billing

descriptiontekenreeksFacultatief

Beschrijving van de operationele categorie.

Voorbeeld: Invoice and payment workflows

colorhex-kleurFacultatief

Dashboard display kleur.

Voorbeeld: #46769b

Voorbeeldverzoek

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

Voorbeeldantwoord

201

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

Mogelijke reacties

201Aangemaakte categorieën

401Ongeldige API-sleutel

422Ongeldige of dubbele waarden

Voorbereiding van het interactieve testformulier...

PATCH/categories/{category_id}

Categorie bijwerken

Een of meer velden wijzigen. Toegestaane velden blijven ongewijzigd.

ToestemmingAPI-sleutel met schrijffunctie

Verzoekvelden

Padparameters

category_idUUID-padVereist

Identificatie van de categorieën.

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

JSON lichaam

nametekenreeksFacultatief

Unieke categorienaam in de werkruimte.

Voorbeeld: Billing

descriptiontekenreeksFacultatief

Beschrijving van de operationele categorie.

Voorbeeld: Invoice and payment workflows

colorhex-kleurFacultatief

Dashboard display kleur.

Voorbeeld: #46769b

Voorbeeldverzoek

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

Voorbeeldantwoord

200

{
    "updated": true
}

Mogelijke reacties

200Verzoek succesvol voltooid

401Ontbrekende, ongeldige of verlopen API-sleutel

403Onvoldoende toestemming

422Verzoekvalidering mislukt

Voorbereiding van het interactieve testformulier...

DELETE/categories/{category_id}

Categorie verwijderen

Verwijder het organisatieonderdeel. Jobs blijven beschikbaar; verwijderde groepsrelaties worden leeg.

ToestemmingAPI-sleutel met schrijffunctie

Verzoekvelden

Padparameters

category_idUUID-padVereist

Identificatie van de categorieën.

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

Voorbeeldverzoek

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

Voorbeeldantwoord

204

No response body

Mogelijke reacties

204Categorieën-item verwijderd

401Ongeldige API-sleutel

404Item niet gevonden

Voorbereiding van het interactieve testformulier...

API DOMAIN

Incidenten

Lees en erken mislukkingen die professionele aandacht vereisen.

Get/incidents

Lijst incidenten

Geef tot 500 incidenten terug, bevolen door openingstijd. Reacties bevatten een open, erkende en opgeloste operationele geschiedenis.

ToestemmingElke API-sleutel

Voorbeeldverzoek

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

Voorbeeldantwoord

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

Mogelijke reacties

200Verzoek succesvol voltooid

401Ontbrekende, ongeldige of verlopen API-sleutel

403Onvoldoende toestemming

422Verzoekvalidering mislukt

Voorbereiding van het interactieve testformulier...

POST/incidents/{incident_id}/acknowledge

Bevestig een incident

Markeer een open incident zoals erkend en registreer de exacte UTC-bevestigingstijd.

ToestemmingAPI-sleutel met schrijffunctie

Verzoekvelden

Padparameters

incident_idinteger padVereist

Incidentidentificatie.

Voorbeeld: 731

Voorbeeldverzoek

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

Voorbeeldantwoord

200

{
    "acknowledged": true
}

Mogelijke reacties

200Verzoek succesvol voltooid

401Ontbrekende, ongeldige of verlopen API-sleutel

403Onvoldoende toestemming

422Verzoekvalidering mislukt

Voorbereiding van het interactieve testformulier...

Bouwen, werken en herstellenElke cron door API.

Sluit uw API-sleutel aan

API-verbinding verifiëren

Voorbeeldverzoek

Voorbeeldantwoord

Mogelijke reacties

Lijst en zoekopdracht cron jobs

Verzoekvelden

Zoekparameters

Voorbeeldverzoek

Voorbeeldantwoord

Mogelijke reacties

Een cron-taak aanmaken

Verzoekvelden

JSON lichaam

Voorbeeldverzoek

Voorbeeldantwoord

Mogelijke reacties

Een cron job ophalen

Verzoekvelden

Padparameters

Voorbeeldverzoek

Voorbeeldantwoord

Mogelijke reacties

Cron-configuratie wijzigen

Verzoekvelden

Padparameters

JSON lichaam

Voorbeeldverzoek

Voorbeeldantwoord

Mogelijke reacties

Een cron-taak definitief verwijderen

Verzoekvelden

Padparameters

Voorbeeldverzoek

Voorbeeldantwoord

Mogelijke reacties

Een cron activeren of activeren

Verzoekvelden

Padparameters

Voorbeeldverzoek

Voorbeeldantwoord

Mogelijke reacties

Een cron uitschakelen

Verzoekvelden

Padparameters

Voorbeeldverzoek

Voorbeeldantwoord

Mogelijke reacties

Wacht op een onmiddellijke executie

Verzoekvelden

Padparameters

Voorbeeldverzoek

Voorbeeldantwoord

Mogelijke reacties

Meerdere crontaken opnieuw activeren

Verzoekvelden

JSON lichaam

Voorbeeldverzoek

Voorbeeldantwoord

Mogelijke reacties

Dupliceer een cron veilig

Verzoekvelden

Padparameters

Voorbeeldverzoek

Voorbeeldantwoord

Mogelijke reacties

Meerdere crontaken pauzeren

Verzoekvelden

JSON lichaam

Voorbeeldverzoek

Voorbeeldantwoord

Mogelijke reacties

Meerdere crontaken naar een groep verplaatsen

Verzoekvelden

JSON lichaam

Voorbeeldverzoek

Voorbeeldantwoord

Mogelijke reacties

Uitvoergeschiedenis tonen

Bouwen, werken en herstellen
Elke cron door API.