Skip to main content
GET
cURL
Requires a Harness Runtime deployed with AgentKit CLI 0.54.0 and scheduled tasks enabled The response may describe a queued, running, or terminal execution; it is available before completion. output contains the final text; inspect error on failure. Timeouts and failures do not automatically retry that occurrence

Authorizations

Authorization
string
header
required

Runtime access credential for a service-authenticated Harness, such as a Runtime API key; shared OAuth deployments do not support background scheduled tasks

Path Parameters

job_id
string
required

Task ID containing 32 lowercase hexadecimal characters

Pattern: ^[a-f0-9]{32}$
run_id
string
required

Execution ID returned in task state or execution history

Pattern: ^[0-9]{13}-[a-f0-9]{20}$

Response

Success

cronjob_id
string
required

Owning task ID

Pattern: ^[a-f0-9]{32}$
run_id
string
required

Execution ID used to read or cancel this occurrence

Pattern: ^[0-9]{13}-[a-f0-9]{20}$
revision
integer
required

Task revision used for this execution

scheduled_at
string<date-time>
required

Scheduled occurrence time in UTC

created_at
string<date-time>
required

Execution record creation time in UTC

prompt
string
required

Prompt for this execution

harness
CronjobHarnessPublicOverrides · object | null
required

Settings applied to each execution of this task; explicit fields override the deployed agent and omitted fields inherit it

timeout_seconds
integer
required

Timeout in seconds for this execution

state
enum<string>
required

Execution state

Available options:
queued,
running,
succeeded,
failed,
cancelled,
skipped,
interrupted
owner
string | null
required

Identifier of the replica executing this occurrence; null before execution begins

started_at
string<date-time> | null
required

Execution start time in UTC; null before execution begins

completed_at
string<date-time> | null
required

Execution completion time in UTC; null while unfinished

lease_until
string<date-time> | null
required

Current execution lease expiry in UTC; null before execution begins

cancel_requested
boolean
required

Whether cancellation has been requested for this execution

output
string
required

Execution output; empty on failure. Successful output is limited to 1 MiB

error
string
required

Failure, cancellation, skip, or interruption details; empty when there is no error

coalesced_from
string<date-time>

Earliest missed occurrence combined into this run, in UTC; present only when occurrences were coalesced

Last modified on September 19, 2026