КронЛюмина
CRONLUME PROFESSIONAL API · V1

Строительство, эксплуатация и восстановление
Каждый крон по API.

Полная справочная и живая тестовая консоль для профессиональных операций cron. Подключите выделенный ключ API, отредактируйте реальные параметры и проверьте точный ответ, возвращенный вашим рабочим пространством CronLume.

25 документированные операцииДжон органы запроса и реагированияноситель аутентификация
Производственная база URLhttps://api.cronlume.com/v1Руководитель по аутентификацииAuthorization: Bearer crl_live_…

Ключи создаются и отменяются по Dashboard → API-ключи.

⌁
Живой API-консоль

Подключите ключ API

Ключ остается в памяти этой страницы и отправляется только в конечную точку, которую вы явно тестируете. Он никогда не добавляется в примеры, URL-адреса или хранилище браузера.

Не подключен
API DOMAIN

аутентификация

Проверьте учетные данные и определите активное рабочее пространство.

Встать/account

Проверьте соединение API

Проверить ключ Bearer и вернуть аутентифицированный идентификатор API-ключа и рабочее пространство. Интерактивная консоль использует эту конечную точку при выборе соединения.

РазрешениеАктивный ключ API

Пример запроса

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

Пример ответа

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

Возможные ответы

200Запрос успешно выполнен
401Пропущенный, недействительный или просроченный ключ API
403Недостаточное разрешение
422Проверка запроса не удалась
Интерактивная тестовая форма...
API DOMAIN

Кроновские рабочие места

Создание, проверка, планирование и управление операциями HTTP cron.

Встать/crons

Список и поиск работы cron

Возвращает рабочие места, заказанные в срочном порядке. Объединение фильтров для быстрого определения местоположения проекта, состояния инцидента или конечной точки.

РазрешениеЛюбой API ключ

Запросить поля

Параметры запросов
searchнитьнеобязательный

Заголовок поиска, URL и описание.

Пример: invoices
statusперечислятьнеобязательный

выживших, здоровых, деградировавших, опустившихся или остановившихся.

Пример: down
activeбулевыйнеобязательный

Фильтруйте активные или инвалидные рабочие места.

Пример: true
group_idUUIDнеобязательный

Фильтр по проекту/сайту группы.

category_idUUIDнеобязательный

Фильтр по категориям.

limitцелое числонеобязательный

От 1 до 100, от 50.

Пример: 50
offsetцелое числонеобязательный

Пагинация компенсирована. По умолчанию 0.

Пример: 0

Пример запроса

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"

Пример ответа

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

Возможные ответы

200Запрос успешно выполнен
401Пропущенный, недействительный или просроченный ключ API
403Недостаточное разрешение
422Проверка запроса не удалась
Интерактивная тестовая форма...
Пост/crons

Создать Cron Job

Создайте полностью контролируемый график HTTP. Необходимые поля намеренно минимальны; каждая оперативная защита может быть настроена по одному и тому же запросу.

РазрешениеЗаписанный ключ API

Запросить поля

Тело Джона
nameнитьтребуемый

Человеческое название, используемое в поиске, оповещениях и графиках инцидентов.

Пример: Generate customer invoices
urlURLтребуемый

Конечная точка HTTP или HTTPS, вызванная исполнителем. Никогда не размещайте учетные данные в URL.

Пример: https://billing.example.com/tasks/invoices
cron_expressionнитьтребуемый

Стандартное выражение пятиполевого кронтаба: минута, час, день месяца, месяц и день недели.

Пример: */15 * * * *
descriptionнитьнеобязательный

Оперативная цель и безопасный контекст для ответчиков. Максимум 600 персонажей.

Пример: Creates invoices for completed billing periods.
criticalityперечислятьнеобязательный

Стандартный, важный или критический. Дефолты важны.

Пример: critical
methodперечислятьнеобязательный

GET, POST, PUT, PATCH, DELETE или HEAD. Дефолты, чтобы получить.

Пример: POST
headersобъектнеобязательный

Заголовки HTTP-запросов. Зашифровано. Не включайте их в запросы поддержки.

Пример: {"Authorization":"Bearer service-token"}
bodyнитьнеобязательный

Тело HTTP-запроса, отправленное в конечную точку.

Пример: {"source":"cronlume"}
group_idUUID |nullнеобязательный

Существующая группа в одном рабочем пространстве.

category_idsUUID[ ]необязательный

Существующие идентификаторы категорий в одном рабочем пространстве.

Пример: []
timezoneТаймзон ИАНАнеобязательный

Timezone используется для оценки экспрессии крон. Дефолты в UTC.

Пример: Europe/Brussels
timeout_secondsцелое числонеобязательный

Максимальная продолжительность запроса. Поддерживаются долгосрочные конечные точки. Дефолты до 120.

Пример: 180
connect_timeout_secondsцелое числонеобязательный

Максимальное время установления соединения. По умолчанию 15.

Пример: 20
follow_redirectsбулевыйнеобязательный

Следуйте перенаправлениям HTTP. По умолчанию.

Пример: 1
verify_tlsбулевыйнеобязательный

Проверьте удаленный сертификат TLS. Оставайтесь включенными в производство.

Пример: 1
expected_status_minцелое числонеобязательный

Самый низкий статус HTTP считается успешным. Дефолты до 200.

Пример: 200
expected_status_maxцелое числонеобязательный

Самый высокий статус HTTP считается успешным. По умолчанию 399.

Пример: 399
max_retriesцелое числонеобязательный

Дополнительные попытки после неудачного запроса. Дефолты до 2.

Пример: 2
retry_backoff_secondsцелое числонеобязательный

Задержка между повторными попытками. Дефолты до 30.

Пример: 30
failure_thresholdцелое числонеобязательный

Последовательные неудавшиеся казни до того, как работа будет рассмотрена. Дефолты до 2.

Пример: 3
recovery_thresholdцелое числонеобязательный

Последующие успехи, необходимые для разрешения инцидента. Дефолты до 1.

Пример: 1
alert_repeat_minutesцелое числонеобязательный

Повторите интервал для постоянных предупреждений об инцидентах. По умолчанию 15.

Пример: 15
grace_secondsцелое числонеобязательный

Планирование льготного периода до пропущенного пробега считается поздним. Дефолты до 60.

Пример: 60
alert_on_pauseбулевыйнеобязательный

Отправляйте оповещения, когда работа автоматически или вручную отключена. По умолчанию.

Пример: 1
failure_action_enabledбулевыйнеобязательный

Вызовите аварийный URL, когда будет достигнута настроенная полоса отказа.

Пример: 1
failure_action_thresholdцелое числонеобязательный

Счет отказов, который запускает аварийный URL. Диапазон 1-20.

Пример: 3
failure_action_urlURL-адреснеобязательный

Срочный HTTP(S) URL. Он должен отличаться от основного URL.

Пример: https://backup.example.com/recover/invoices
is_activeбулевыйнеобязательный

Создайте работу активной или остановленной. По умолчанию.

Пример: 1

Пример запроса

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

Пример ответа

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

Возможные ответы

201Создана работа Cron
401Недействительный ключ API
422Недостающее поле, недействительное выражение cron или недействительный аварийный URL
Интерактивная тестовая форма...
Встать/crons/{cron_id}

Отыскать работу cron

Вернуть полную конфигурацию и текущее состояние работы, включая расшифрованные заголовки запросов для авторизованного инженерного использования. Относитесь к ответу как к чувствительному.

РазрешениеЛюбой API ключ

Запросить поля

Параметры пути
cron_idПуть UUIDтребуемый

Идентификатор работы Cron.

Пример: a870d9ac-3a0f-49bb-b8e2-5f392fffc821

Пример запроса

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

Пример ответа

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

Возможные ответы

200Крон вернулся на работу
401Недействительный ключ API
404Работа Cron не найдена в этом рабочем пространстве
Интерактивная тестовая форма...
ПАТЧ/crons/{cron_id}

Изменение конфигурации cron

Обновление одного или нескольких поддерживаемых полей. Опущенные поля сохраняют свои текущие значения. Изменение графика или часового пояса пересчитывает next run at.

РазрешениеЗаписанный ключ API

Запросить поля

Параметры пути
cron_idПуть UUIDтребуемый

Идентификатор работы Cron.

Пример: a870d9ac-3a0f-49bb-b8e2-5f392fffc821
Тело Джона
nameнитьнеобязательный

Человеческое название, используемое в поиске, оповещениях и графиках инцидентов.

Пример: Generate customer invoices
urlURLнеобязательный

Конечная точка HTTP или HTTPS, вызванная исполнителем. Никогда не размещайте учетные данные в URL.

Пример: https://billing.example.com/tasks/invoices
cron_expressionнитьнеобязательный

Стандартное выражение пятиполевого кронтаба: минута, час, день месяца, месяц и день недели.

Пример: */15 * * * *
descriptionнитьнеобязательный

Оперативная цель и безопасный контекст для ответчиков. Максимум 600 персонажей.

Пример: Creates invoices for completed billing periods.
criticalityперечислятьнеобязательный

Стандартный, важный или критический. Дефолты важны.

Пример: critical
methodперечислятьнеобязательный

GET, POST, PUT, PATCH, DELETE или HEAD. Дефолты, чтобы получить.

Пример: POST
headersобъектнеобязательный

Заголовки HTTP-запросов. Зашифровано. Не включайте их в запросы поддержки.

Пример: {"Authorization":"Bearer service-token"}
bodyнитьнеобязательный

Тело HTTP-запроса, отправленное в конечную точку.

Пример: {"source":"cronlume"}
group_idUUID |nullнеобязательный

Существующая группа в одном рабочем пространстве.

category_idsUUID[ ]необязательный

Существующие идентификаторы категорий в одном рабочем пространстве.

Пример: []
timezoneТаймзон ИАНАнеобязательный

Timezone используется для оценки экспрессии крон. Дефолты в UTC.

Пример: Europe/Brussels
timeout_secondsцелое числонеобязательный

Максимальная продолжительность запроса. Поддерживаются долгосрочные конечные точки. Дефолты до 120.

Пример: 180
connect_timeout_secondsцелое числонеобязательный

Максимальное время установления соединения. По умолчанию 15.

Пример: 20
follow_redirectsбулевыйнеобязательный

Следуйте перенаправлениям HTTP. По умолчанию.

Пример: 1
verify_tlsбулевыйнеобязательный

Проверьте удаленный сертификат TLS. Оставайтесь включенными в производство.

Пример: 1
expected_status_minцелое числонеобязательный

Самый низкий статус HTTP считается успешным. Дефолты до 200.

Пример: 200
expected_status_maxцелое числонеобязательный

Самый высокий статус HTTP считается успешным. По умолчанию 399.

Пример: 399
max_retriesцелое числонеобязательный

Дополнительные попытки после неудачного запроса. Дефолты до 2.

Пример: 2
retry_backoff_secondsцелое числонеобязательный

Задержка между повторными попытками. Дефолты до 30.

Пример: 30
failure_thresholdцелое числонеобязательный

Последовательные неудавшиеся казни до того, как работа будет рассмотрена. Дефолты до 2.

Пример: 3
recovery_thresholdцелое числонеобязательный

Последующие успехи, необходимые для разрешения инцидента. Дефолты до 1.

Пример: 1
alert_repeat_minutesцелое числонеобязательный

Повторите интервал для постоянных предупреждений об инцидентах. По умолчанию 15.

Пример: 15
grace_secondsцелое числонеобязательный

Планирование льготного периода до пропущенного пробега считается поздним. Дефолты до 60.

Пример: 60
alert_on_pauseбулевыйнеобязательный

Отправляйте оповещения, когда работа автоматически или вручную отключена. По умолчанию.

Пример: 1
failure_action_enabledбулевыйнеобязательный

Вызовите аварийный URL, когда будет достигнута настроенная полоса отказа.

Пример: 1
failure_action_thresholdцелое числонеобязательный

Счет отказов, который запускает аварийный URL. Диапазон 1-20.

Пример: 3
failure_action_urlURL-адреснеобязательный

Срочный HTTP(S) URL. Он должен отличаться от основного URL.

Пример: https://backup.example.com/recover/invoices
is_activeбулевыйнеобязательный

Создайте работу активной или остановленной. По умолчанию.

Пример: 1

Пример запроса

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

Пример ответа

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

Возможные ответы

200Запрос успешно выполнен
401Пропущенный, недействительный или просроченный ключ API
403Недостаточное разрешение
422Проверка запроса не удалась
Интерактивная тестовая форма...
Удалить/crons/{cron_id}

Постоянно удалять работу cron

Исключить работу и историю ее выполнения. Эта операция является постоянной и не возвращает тело ответа.

РазрешениеЗаписанный ключ API

Запросить поля

Параметры пути
cron_idПуть UUIDтребуемый

Идентификатор работы Cron.

Пример: a870d9ac-3a0f-49bb-b8e2-5f392fffc821

Пример запроса

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

Пример ответа

204
No response body

Возможные ответы

204Работа Cron и связанная с ней история удалены
401Недействительный ключ API
404Крон не найдена работа
Интерактивная тестовая форма...
Пост/crons/{cron_id}/activate

Активировать или реактивировать крону

Очищает дату и причину паузы, сбрасывает замки и рассчитывает следующее исполнение.

РазрешениеЗаписанный ключ API

Запросить поля

Параметры пути
cron_idПуть UUIDтребуемый

Идентификатор работы Cron.

Пример: a870d9ac-3a0f-49bb-b8e2-5f392fffc821

Пример запроса

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"

Пример ответа

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

Возможные ответы

200Состояние Крона изменилось
401Недействительный ключ API
404Крон не найдена работа
Интерактивная тестовая форма...
Пост/crons/{cron_id}/deactivate

Отключить крону

Прекращает будущие казни и записывает точную временную метку паузы UTC и причину API.

РазрешениеЗаписанный ключ API

Запросить поля

Параметры пути
cron_idПуть UUIDтребуемый

Идентификатор работы Cron.

Пример: a870d9ac-3a0f-49bb-b8e2-5f392fffc821

Пример запроса

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"

Пример ответа

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

Возможные ответы

200Состояние Крона изменилось
401Недействительный ключ API
404Крон не найдена работа
Интерактивная тестовая форма...
Пост/crons/{cron_id}/run

Немедленная казнь

Перемещает next run at в текущее время UTC. Планировщик принимает работу асинхронно.

РазрешениеЗаписанный ключ API

Запросить поля

Параметры пути
cron_idПуть UUIDтребуемый

Идентификатор работы Cron.

Пример: a870d9ac-3a0f-49bb-b8e2-5f392fffc821

Пример запроса

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"

Пример ответа

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

Возможные ответы

202Казнь в очереди
409Крон неактивен; сначала активируйте его.
401Недействительный ключ API
404Крон не найдена работа
Интерактивная тестовая форма...
Пост/crons/bulk-activate

Реактивировать несколько рабочих мест cron

Реактивировать выбранные рабочие места после отключения сервера или устранения инцидента. Неизвестные или уже активные идентификаторы игнорируются.

РазрешениеЗаписанный ключ API

Запросить поля

Тело Джона
job_idsUUID[ ]требуемый

Уникальные идентификаторы cron для реактивации. Максимальная рекомендуемая партия: 200.

Пример: ["a870d9ac-3a0f-49bb-b8e2-5f392fffc821"]

Пример запроса

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

Пример ответа

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

Возможные ответы

200Запрос успешно выполнен
401Пропущенный, недействительный или просроченный ключ API
403Недостаточное разрешение
422Проверка запроса не удалась
Интерактивная тестовая форма...
Пост/crons/{cron_id}/duplicate

Безопасно дублировать крону

Создайте точную оперативную копию, включая категории, каналы оповещения, зашифрованные заголовки и тело запроса. Копия всегда приостанавливается и четко называется, поэтому ее можно просмотреть перед активацией, не вызывая двойного исполнения.

РазрешениеЗаписанный ключ API

Запросить поля

Параметры пути
cron_idПуть UUIDтребуемый

Идентификатор работы cron.

Пример: a870d9ac-3a0f-49bb-b8e2-5f392fffc821

Пример запроса

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"

Пример ответа

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

Возможные ответы

201Созданный дубликат
401Недействительный ключ API
404Источник Cron не найден
Интерактивная тестовая форма...
Пост/crons/bulk-pause

Приостановить работу нескольких крон

Приостановить до 200 рабочих мест за одну операцию. CronLume записывает точное время паузы UTC и причину разработчика-API на каждой затронутой работе. Неизвестные, недоступные и уже приостановленные идентификаторы считаются проигнорированными.

РазрешениеЗаписанный ключ API

Запросить поля

Тело Джона
job_idsUUID[ ]требуемый

Уникальные идентификаторы cron для паузы. Максимум 200.

Пример: ["a870d9ac-3a0f-49bb-b8e2-5f392fffc821"]

Пример запроса

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

Пример ответа

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

Возможные ответы

200Запрос успешно выполнен
401Пропущенный, недействительный или просроченный ключ API
403Недостаточное разрешение
422Проверка запроса не удалась
Интерактивная тестовая форма...
Пост/crons/bulk-move

Переместить несколько крон в группу

Переместить до 200 рабочих мест в проект, веб-сайт, службу или группу клиентов. Отправьте group id как null, чтобы сделать выбранные задания негруппированными. Можно использовать только задания и группы из аутентифицированного рабочего пространства.

РазрешениеЗаписанный ключ API

Запросить поля

Тело Джона
job_idsUUID[ ]требуемый

Уникальные идентификаторы cron для перемещения. Максимум 200.

Пример: ["a870d9ac-3a0f-49bb-b8e2-5f392fffc821"]
group_idUUID |nullтребуемый

Идентификатор группы назначения или нуль для негруппированных.

Пример: 6ef63789-baf1-44fc-99bb-0c5ce2d37a8b

Пример запроса

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

Пример ответа

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

Возможные ответы

200Запрос успешно выполнен
401Пропущенный, недействительный или просроченный ключ API
403Недостаточное разрешение
422Проверка запроса не удалась
Интерактивная тестовая форма...
API DOMAIN

Казни

Исследуйте время, результаты HTTP, повторы и аварийные действия.

Встать/crons/{cron_id}/executions

История исполнения

Проверить время отклика, статус HTTP, повторные запросы и доказательства безопасного ответа для одного крона. Последняя казнь возвращается первой.

РазрешениеЛюбой API ключ

Запросить поля

Параметры пути
cron_idПуть UUIDтребуемый

Идентификатор работы Cron.

Пример: a870d9ac-3a0f-49bb-b8e2-5f392fffc821
Параметры запросов
limitцелое числонеобязательный

От 1 до 200, от 50.

Пример: 50

Пример запроса

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"

Пример ответа

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

Возможные ответы

200Запрос успешно выполнен
401Пропущенный, недействительный или просроченный ключ API
403Недостаточное разрешение
422Проверка запроса не удалась
Интерактивная тестовая форма...
Встать/crons/{cron_id}/failure-actions

Список казней в чрезвычайных ситуациях

Проверяйте каждый вызов URL-адреса восстановления, вызванный правилом последовательного отказа.

РазрешениеЛюбой API ключ

Запросить поля

Параметры пути
cron_idПуть UUIDтребуемый

Идентификатор работы Cron.

Пример: a870d9ac-3a0f-49bb-b8e2-5f392fffc821
Параметры запросов
limitцелое числонеобязательный

От 1 до 200, от 50.

Пример: 50

Пример запроса

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"

Пример ответа

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

Возможные ответы

200Запрос успешно выполнен
401Пропущенный, недействительный или просроченный ключ API
403Недостаточное разрешение
422Проверка запроса не удалась
Интерактивная тестовая форма...
API DOMAIN

Организация

Структурировать флоты по проектам, веб-сайту, обслуживанию, клиенту и операционной категории.

Встать/groups

Список групп

Возвращайте каждый проект, веб-сайт, сервис или другой, настроенный в аутентифицированном рабочем пространстве.

РазрешениеЛюбой API ключ

Пример запроса

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

Пример ответа

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

Возможные ответы

200Запрос успешно выполнен
401Пропущенный, недействительный или просроченный ключ API
403Недостаточное разрешение
422Проверка запроса не удалась
Интерактивная тестовая форма...
Пост/groups

Создайте группу

Создать многоразовый проект, веб-сайт, сервис или другое для организации парка крон.

РазрешениеЗаписанный ключ API

Запросить поля

Тело Джона
nameнитьтребуемый

Уникальное название группы внутри рабочего пространства.

Пример: Billing platform
group_typeперечислятьнеобязательный

проект, сайт, сервис или другое.

Пример: service
client_referenceструна |необязательный

Клиент, контракт или внутренняя ссылка. Максимум 160 символов.

Пример: CLIENT-ACME-0042
descriptionструна |необязательный

Цель и контекст собственности.

Пример: Customer billing automation
colorшестицветныйнеобязательный

Цвет дисплея приборной панели.

Пример: #147d64

Пример запроса

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

Пример ответа

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

Возможные ответы

201Группы, созданные
401Недействительный ключ API
422Недействительные или дублирующие значения
Интерактивная тестовая форма...
ПАТЧ/groups/{group_id}

Обновление группы

Измените одно или несколько полей. Опущенные поля остаются неизменными.

РазрешениеЗаписанный ключ API

Запросить поля

Параметры пути
group_idПуть UUIDтребуемый

Идентификатор групп.

Пример: 6ef63789-baf1-44fc-99bb-0c5ce2d37a8b
Тело Джона
nameнитьнеобязательный

Уникальное название группы внутри рабочего пространства.

Пример: Billing platform
group_typeперечислятьнеобязательный

проект, сайт, сервис или другое.

Пример: service
client_referenceструна |необязательный

Клиент, контракт или внутренняя ссылка. Максимум 160 символов.

Пример: CLIENT-ACME-0042
descriptionструна |необязательный

Цель и контекст собственности.

Пример: Customer billing automation
colorшестицветныйнеобязательный

Цвет дисплея приборной панели.

Пример: #147d64

Пример запроса

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

Пример ответа

200
{
    "updated": true
}

Возможные ответы

200Запрос успешно выполнен
401Пропущенный, недействительный или просроченный ключ API
403Недостаточное разрешение
422Проверка запроса не удалась
Интерактивная тестовая форма...
Удалить/groups/{group_id}

Исключить группу

Удалить организационный элемент. Работа остается доступной; удаленные групповые отношения становятся пустыми.

РазрешениеЗаписанный ключ API

Запросить поля

Параметры пути
group_idПуть UUIDтребуемый

Идентификатор групп.

Пример: 6ef63789-baf1-44fc-99bb-0c5ce2d37a8b

Пример запроса

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

Пример ответа

204
No response body

Возможные ответы

204Пункты групп исключены
401Недействительный ключ API
404Пункт не найден
Интерактивная тестовая форма...
Встать/categories

Перечень категорий

Возврат каждой операционной категории, настроенной в аутентифицированном рабочем пространстве.

РазрешениеЛюбой API ключ

Пример запроса

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

Пример ответа

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

Возможные ответы

200Запрос успешно выполнен
401Пропущенный, недействительный или просроченный ключ API
403Недостаточное разрешение
422Проверка запроса не удалась
Интерактивная тестовая форма...
Пост/categories

Создание категории

Создать многоразовую операционную категорию для организации кронного флота.

РазрешениеЗаписанный ключ API

Запросить поля

Тело Джона
nameнитьтребуемый

Уникальное название категории внутри рабочего пространства.

Пример: Billing
descriptionструна |необязательный

Описание оперативной категории.

Пример: Invoice and payment workflows
colorшестицветныйнеобязательный

Цвет дисплея приборной панели.

Пример: #46769b

Пример запроса

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

Пример ответа

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

Возможные ответы

201Категории созданные
401Недействительный ключ API
422Недействительные или дублирующие значения
Интерактивная тестовая форма...
ПАТЧ/categories/{category_id}

Категория обновления

Измените одно или несколько полей. Опущенные поля остаются неизменными.

РазрешениеЗаписанный ключ API

Запросить поля

Параметры пути
category_idПуть UUIDтребуемый

Идентификатор категорий.

Пример: 125976d5-c276-481c-984c-a9b4b70e477e
Тело Джона
nameнитьнеобязательный

Уникальное название категории внутри рабочего пространства.

Пример: Billing
descriptionструна |необязательный

Описание оперативной категории.

Пример: Invoice and payment workflows
colorшестицветныйнеобязательный

Цвет дисплея приборной панели.

Пример: #46769b

Пример запроса

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

Пример ответа

200
{
    "updated": true
}

Возможные ответы

200Запрос успешно выполнен
401Пропущенный, недействительный или просроченный ключ API
403Недостаточное разрешение
422Проверка запроса не удалась
Интерактивная тестовая форма...
Удалить/categories/{category_id}

Исключить категорию

Удалить организационный элемент. Работа остается доступной; удаленные групповые отношения становятся пустыми.

РазрешениеЗаписанный ключ API

Запросить поля

Параметры пути
category_idПуть UUIDтребуемый

Идентификатор категорий.

Пример: 125976d5-c276-481c-984c-a9b4b70e477e

Пример запроса

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

Пример ответа

204
No response body

Возможные ответы

204Пункты категорий исключены
401Недействительный ключ API
404Пункт не найден
Интерактивная тестовая форма...
API DOMAIN

Инциденты

Читайте и признавайте ошибки, требующие профессионального внимания.

Встать/incidents

Список инцидентов

Возврат до 500 инцидентов, заказанных по времени открытия. Ответы содержат открытую, признанную и урегулированную оперативную историю.

РазрешениеЛюбой API ключ

Пример запроса

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

Пример ответа

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

Возможные ответы

200Запрос успешно выполнен
401Пропущенный, недействительный или просроченный ключ API
403Недостаточное разрешение
422Проверка запроса не удалась
Интерактивная тестовая форма...
Пост/incidents/{incident_id}/acknowledge

Признать инцидент

Отметьте открытый инцидент и запишите точное время подтверждения UTC.

РазрешениеЗаписанный ключ API

Запросить поля

Параметры пути
incident_idцелочисленный путьтребуемый

Идентификатор инцидента.

Пример: 731

Пример запроса

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

Пример ответа

200
{
    "acknowledged": true
}

Возможные ответы

200Запрос успешно выполнен
401Пропущенный, недействительный или просроченный ключ API
403Недостаточное разрешение
422Проверка запроса не удалась
Интерактивная тестовая форма...