Skip to main content
GET
Get a schedule

Authorizations

Authorization
string
header
required

Personal Access Token. Send as Authorization: Bearer hq_pat_....

Path Parameters

id
string<uuid>
required

Schedule id

Response

Schedule detail

args
any
required
consecutive_failure_count
integer<int32>
required
failure_count
integer<int32>
required
fire_count
integer<int32>
required
id
string<uuid>
required
max_duration_secs
integer<int32>
required

Wall-clock cap per fire (seconds). A fire that runs past it is killed and marked failed. Editable; default 1800.

name
string
required
owner_user_id
string<uuid>
required
state
string
required
trigger
any
required
description
string | null
last_fire_at
string<date-time> | null
last_fire_lag_ms
integer<int64> | null
last_fire_status
string | null
last_run_conversation_id
string<uuid> | null

The conversation backing this schedule's most recent run, if any. Scheduled-run threads are hidden from the main conversation list; the Schedules page uses this to offer a read-only "last run" link.

next_fire_at
string<date-time> | null
owner_display_name
string | null
owner_external_id
string | null