Reconcile and dispatch at most one due recipient of an already running task, preserving all call, credit, concurrency and timing guards

Reconciles actual calls and tries to process at most one due recipient of an already running task. Requires the current revision; it never starts or resumes a task. It uses the same calling window, suppression, budget reservation, credit, capacity and atomic claim as cron. The persisted opt-in dispatchOrder: "first_attempts_first" prioritizes due recipients without a counted attempt; pre-dial rejections (countsAsAttempt: false) retain this priority. Existing item order remains the default, and future nextAttemptAt values are respected. Read the current state after an uncertain result instead of blindly repeating a request. Every new logical tick needs a new Idempotency-Key, even when the revision has not changed.

post/v1/tasks/{id}/process

Request

  • Base URL: https://volai.cz
  • URL: https://volai.cz/v1/tasks/{id}/process
  • Auth: HTTP bearer

Path parameters

idstring required

Headers

Idempotency-Keystring

Optional key for one logical request. Its scope is global to this API key, independent of the HTTP method, path, or body: use a new value for every distinct logical action across all endpoints and request bodies, and reuse it only to retry the exact same logical request. Reusing a non-blank key within 24 hours returns the stored response; a concurrent request with the same key returns 409 idempotency_in_progress. A missing or whitespace-only value disables idempotency.

Request body

revisioninteger required

Current task revision from GET /v1/tasks/{id}. On revision_conflict reload and review the new state before retrying. Reconciliation accepts omission; other task changes require the current revision.

Response

Processing outcome and current task

statusstring required

Changes

No recorded changes to this operation across all 1 revision of this API.