Skip to content
Artist Alley

List future-dated pending jobs

GET
/admin/jobs/scheduled

Read-only view of pending jobs with a scheduled_for in the future (#401). There is no cron subsystem — these are jobs a producer enqueued to run later (e.g. the digest coordinator’s self-reschedule). Soonest first. Gated on system.jobs.read.

Authorizations

Section titled “Authorizations ”

Parameters

Section titled “ Parameters ”

Query Parameters

Section titled “Query Parameters ”
limit
integer
default: 50 >= 1 <= 200
offset
integer
0

Responses

Section titled “ Responses ”

200

Section titled “200 ”

Scheduled jobs + total.

object
items
required
Array<object>
object
id
required
string format: uuid
type
required
string
status
required
string
priority
required
integer
attempts
required
integer
max_attempts
required
integer
scheduled_for
string format: date-time
nullable
enqueued_at
string format: date-time
nullable
due_in_seconds
required

Seconds until scheduled_for (server-computed).

integer format: int64
total
required
integer format: int64

401

Section titled “401 ”

Authentication required, missing, or invalid

object
error
required

Human-readable error summary

string
Example
the request could not be completed
Example
{
  "error": "authentication required: sign in and retry with a valid session or API token"
}

403

Section titled “403 ”

Authenticated but missing required capabilities

object
error
required

Human-readable error summary

string
Example
the request could not be completed