Skip to main content
PUT
Create or revision-conditionally update one resident schedule

Authorizations

Authorization
string
header
required

Exactly one Authorization: Bearer value from the token file

Headers

If-None-Match
string
Allowed value: "*"
If-Match
string
Maximum string length: 96

Path Parameters

id
string
required
Required string length: 1 - 255

Body

application/json
maxCostUsd
number
required
missed
enum<string>
required
Available options:
catch-up,
catch-up-once,
skip
when
object
required
workflow
string
required
Maximum string length: 1024
Pattern: ^[^/].*\.nika$
active
boolean
afterSkip
enum<string>
Available options:
next_slot,
on_completion
inputs
object

Per-fire inputs bound on every resident fire (#1370): one scalar per key the workflow declares under inputs:, coerced by the declared type exactly as the CLI --var edge does, then judged by the same literal admission validator as POST /v1/jobs. Unknown keys, values the declared type refuses, missing required inputs and the @env: channel are refused at PUT and again at fire.

jitter
enum<string>
Available options:
hash
maxLatenessSeconds
integer
Required range: x >= 0
overlap
enum<string>
Available options:
skip,
queue,
replace
pauseReason
string
Maximum string length: 1024
pauseUntil
string<date>
tolerance
string

Response

Applied or unchanged

applied
boolean
required
changed
boolean
required
status
object
required

Normalized definition, origin, distinct schedule revision, active/pause state, due verdict, bounded next slots with shift evidence, earliest wake hint, and last durable decision.