---
title: "Publish due scheduled variants"
method: POST
path: "/api/v1/jobs/publish-due"
tags: ["jobs"]
---

# Publish due scheduled variants

`POST /api/v1/jobs/publish-due`

## Request

- Base URL: `https://api.cadencz.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.cadencz.com/api/v1/jobs/publish-due`
- Auth: none declared

Cloudflare Cron callback endpoint. Authenticates with `WORKER_SECRET`, claims due scheduled variants from the database, and publishes them. This is the preferred scheduler path for posts scheduled more than a few days ahead.

## Response `200`

Successful Response

- PublishDueJobResponse
  - `status` 'ok', required
  - `checked` integer, required
  - `claimed` integer, required
  - `published` integer, required
  - `failed` integer, required
  - `retryable` integer, required
  - `skipped` integer, required

## Other responses

- `401`: Missing or invalid worker secret.
- `503`: Required infrastructure or provider config is unavailable.

---

[API](https://skmtc.dev/cadencz/apis/cadencz-api.md) · [All operations](https://skmtc.dev/cadencz/apis/cadencz-api/llms.txt) · [OpenAPI document](https://skmtc.dev/cadencz/apis/cadencz-api/revisions/3392fe5e93db?raw)