Create or revision-conditionally update one resident schedule
Create requires If-None-Match: *. Update requires the exact ETag in If-Match. Identical lost-response retries are unchanged and retain the revision. A refused precondition answers 412 with the schedule’s current revision (null when none exists). A definition the planner or the schedule validator refuses answers 422 with its findings; a malformed body, refused inputs or a refused workflow answer 422 with the error envelope.
PUT
/
v1
/
schedules
/
{id}
Create or revision-conditionally update one resident schedule
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.
Normalized definition, origin, distinct schedule revision, active/pause state, due verdict, bounded next slots with shift evidence, earliest wake hint, and last durable decision.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Nika","description":"Nika turns repeatable AI work into a .nika file you keep: checked before it runs, run with the model you choose, proven afterwards.","colors":{"primary":"#2f6bff","light":"#8db4ff","dark":"#2f6bff"},"logo":{"light":"https://mintcdn.com/supernovae-acdf3706/3ObRrFNWymK8fsLG/images/logo-light.svg?fit=max\u0026auto=format\u0026n=3ObRrFNWymK8fsLG\u0026q=85\u0026s=73b2f60862ed01f97cfa045151df991e","dark":"https://mintcdn.com/supernovae-acdf3706/3ObRrFNWymK8fsLG/images/logo-dark.svg?fit=max\u0026auto=format\u0026n=3ObRrFNWymK8fsLG\u0026q=85\u0026s=ae6d5ed9959c0ecb505ee6dd3bf66fe1","href":"/introduction"},"favicon":"https://mintcdn.com/supernovae-acdf3706/3ObRrFNWymK8fsLG/images/favicon.svg?fit=max\u0026auto=format\u0026n=3ObRrFNWymK8fsLG\u0026q=85\u0026s=e2b5356160334944fea5bc30352f8b97","appearance":{"default":"dark"},"background":{"decoration":"gradient","color":{"light":"#F4F6FC","dark":"#08090b"}},"navbar":{"links":[{"href":"/getting-started/installation","label":"Install"},{"href":"https://nika.sh","label":"nika.sh"},{"href":"https://github.com/supernovae-st/nika","type":"github"}],"primary":{"type":"button","label":"Build with the SDK","href":"/sdk/start/quickstart"}},"footer":{"socials":{"github":"https://github.com/supernovae-st/nika","x":"https://x.com/ThibautMelen"},"links":[{"header":"Nika","items":[{"label":"Site","href":"https://nika.sh"},{"label":"Current status","href":"/reference/status"},{"label":"Constellation","href":"/reference/constellation"}]},{"header":"Build","items":[{"label":"Language spec (Apache-2.0)","href":"https://github.com/supernovae-st/nika-spec"},{"label":"Source (AGPL)","href":"https://github.com/supernovae-st/nika"},{"label":"TypeScript SDK","href":"/sdk/overview"},{"label":"Homebrew tap","href":"https://github.com/supernovae-st/homebrew-tap"}]},{"header":"Studio","items":[{"label":"SuperNovae","href":"https://supernovae.studio"}]}]},"search":{"prompt":"Search Nika docs…"},"seo":{"metatags":{"og:image":"https://docs.nika.sh/images/og-card.png","twitter:card":"summary_large_image"}},"fonts":{"family":"Inter"},"styling":{"eyebrows":"section","codeblocks":"system","latex":true},"banner":{"content":"New here? Write a workflow, run it, inspect a real result. No account or API key. [Start here →](/introduction)","dismissible":true},"contextual":{"options":["copy","view","chatgpt","claude"],"display":"header"},"metadata":{"timestamp":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"supernovae-acdf3706","hasAudioNarration":false,"actualSubdomain":"supernovae-acdf3706","customDomains":["docs.nika.sh"],"gitSource":{"type":"github","owner":"supernovae-st","repo":"nika-docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"feedback":{"thumbs":true,"agentFeedback":true,"edits":true,"issues":true},"entitlements":{},"buildId":"6af39d824e60351b9862c9e1","clientVersion":"0.0.4102","searchFilterCounts":[{"language":"default","tag":"Reference","count":158},{"language":"default","tag":"Language fields","count":109},{"language":"default","tag":"Guide","count":63},{"language":"default","tag":"SDK","count":54},{"language":"default","tag":"Examples","count":33},{"language":"default","tag":"Tool contracts","count":30},{"language":"default","tag":"Verbs and models","count":29},{"language":"default","tag":"Agents \u0026 integrations","count":28},{"language":"default","tag":"Remote API","count":24},{"language":"default","tag":"Tasks and dependencies","count":22}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"global.css","content":".mermaid svg,[data-mermaid] svg,.prose .mermaid svg{background:transparent!important}pre.mermaid,div.mermaid{background:transparent!important}.mermaid .edgePaths path{stroke:#4a4540!important}.mermaid .edgeLabel{background-color:transparent!important;color:#b8b2aa!important}.mermaid .flowchart-link{stroke:#4a4540!important}.mermaid{display:flex;justify-content:center;padding:0.75rem 0}.card,[class*=\"card\"] a{transition:border-color 0.2s ease, transform 0.2s ease}.card:hover{border-color:rgba(159, 208, 255, 0.45)!important;transform:translateY(-1px)}.dark pre{background-color:#0a1226!important}#banner,[data-component=\"banner\"]{background:linear-gradient(90deg, #0a1226, #04050d)!important;color:#cfe6ff!important}#banner a,[data-component=\"banner\"] a{color:#9fd0ff!important}.sdk-flight{--sdk-flight-ink: #cfe6ff;--sdk-flight-signal: #8db4ff;position:relative;isolation:isolate;overflow:hidden;margin:1.75rem 0;border:1px solid rgb(141 180 255 / 0.24);border-radius:0.55rem;background:radial-gradient(80% 120% at 92% -18%, rgb(47 107 255 / 0.14), transparent 58%),\n linear-gradient(180deg, transparent 0 94%, rgb(141 180 255 / 0.055) 94% 94.5%, transparent 94.5%),\n linear-gradient(90deg, rgb(141 180 255 / 0.035) 1px, transparent 1px) 0 0 / 2rem 2rem,\n linear-gradient(rgb(141 180 255 / 0.035) 1px, transparent 1px) 0 0 / 2rem 2rem,\n linear-gradient(145deg, rgb(10 18 38 / 0.96), rgb(4 5 13 / 0.98));box-shadow:inset 0 1px 0 rgb(255 255 255 / 0.055),\n inset 0 0 5rem rgb(47 107 255 / 0.06),\n 0 2rem 5rem -3.4rem rgb(47 107 255 / 0.62)}.sdk-flight::before{content:\"\";position:absolute;z-index:-1;inset:0;pointer-events:none;background:radial-gradient(circle at 9% 24%, rgb(159 208 255 / 0.7) 0 1px, transparent 1.4px),\n radial-gradient(circle at 23% 78%, rgb(159 208 255 / 0.38) 0 1px, transparent 1.4px),\n radial-gradient(circle at 34% 47%, rgb(159 208 255 / 0.3) 0 0.8px, transparent 1.3px),\n radial-gradient(circle at 46% 19%, rgb(159 208 255 / 0.5) 0 1px, transparent 1.4px),\n radial-gradient(circle at 57% 88%, rgb(159 208 255 / 0.34) 0 0.8px, transparent 1.3px),\n radial-gradient(circle at 68% 68%, rgb(159 208 255 / 0.42) 0 1px, transparent 1.4px),\n radial-gradient(circle at 77% 16%, rgb(159 208 255 / 0.32) 0 0.8px, transparent 1.3px),\n radial-gradient(circle at 88% 31%, rgb(159 208 255 / 0.62) 0 1px, transparent 1.4px),\n radial-gradient(circle at 94% 82%, rgb(159 208 255 / 0.36) 0 0.8px, transparent 1.3px);opacity:0.7;animation:sdk-doc-particles 9s ease-in-out infinite alternate}.sdk-flight::after{content:\"\";position:absolute;top:0.8rem;right:0.8rem;width:0.55rem;height:0.55rem;border-top:1px solid rgb(159 208 255 / 0.52);border-right:1px solid rgb(159 208 255 / 0.52)}.sdk-flight>span{display:block;padding:0.72rem 1rem 0.68rem;border-bottom:1px solid rgb(141 180 255 / 0.16);background:linear-gradient(90deg, rgb(47 107 255 / 0.055), transparent 58%);font:0.66rem/1.2 ui-monospace, SFMono-Regular, Menlo, monospace;letter-spacing:0.17em;color:var(--sdk-flight-signal);text-transform:uppercase}.sdk-flight>span::before{content:\"[ SYS ]\";margin-right:0.7rem;color:rgb(207 230 255 / 0.46)}.sdk-flight pre,.dark .sdk-flight pre{overflow-x:auto;margin:0!important;padding:clamp(1.15rem, 3vw, 2rem)!important;border:0!important;background:transparent!important;scrollbar-color:rgb(141 180 255 / 0.32) transparent;color:var(--sdk-flight-ink)!important;font-size:clamp(0.71rem, 1.5vw, 0.84rem)!important;line-height:1.75!important;text-shadow:0 0 1.25rem rgb(141 180 255 / 0.18)}.sdk-flight pre:focus-visible{outline:1px solid rgb(141 180 255 / 0.72)!important;outline-offset:-0.25rem}.sdk-flight-compact pre,.dark .sdk-flight-compact pre{padding-block:1.15rem!important}@keyframes sdk-doc-particles{to{transform:translate3d(0.4rem, -0.55rem, 0);opacity:0.42}}@media (prefers-reduced-motion: reduce){.sdk-flight::before{animation:none}}html{-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale}.prose{line-height:1.6}.prose p{max-width:72ch;text-wrap:pretty;overflow-wrap:break-word}.prose li{overflow-wrap:break-word}.prose :is(h1,h2,h3){line-height:1.15;letter-spacing:-0.018em;text-wrap:balance;scroll-margin-top:13.5rem}.prose :is(h4,h5,h6){line-height:1.25;scroll-margin-top:13.5rem}@media (min-width: 768px){.prose :is(h1,h2,h3,h4,h5,h6){scroll-margin-top:10rem}}.prose table{font-variant-numeric:tabular-nums}.prose a{text-underline-position:from-font;text-decoration-thickness:from-font}.prose a:focus-visible,.card:focus-visible,[class*=\"card\"] a:focus-visible,pre:focus-visible,button:focus-visible{outline:2px solid #2f6bff;outline-offset:2px}.dark .prose a:focus-visible,.dark .card:focus-visible,.dark [class*=\"card\"] a:focus-visible,.dark pre:focus-visible,.dark button:focus-visible{outline-color:#8db4ff}.dark pre,pre{line-height:1.65}@media (max-width: 640px){input,textarea,select{font-size:16px}.card:hover{transform:none}}@media (prefers-reduced-motion: reduce){.card,[class*=\"card\"] a{transition:none}.card:hover{transform:none}}::selection{background:rgb(47 107 255 / 0.22);color:#08090b}.dark ::selection{background:rgb(47 107 255 / 0.38);color:#cfe6ff}"}],"page":{"pagePath":"api-reference/create-or-revision-conditionally-update-one-resident-schedule","slug":"/api-reference/create-or-revision-conditionally-update-one-resident-schedule","pageMetadata":{"title":"Create or revision-conditionally update one resident schedule","description":"Create requires If-None-Match: *. Update requires the exact ETag in If-Match. Identical lost-response retries are unchanged and retain the revision. A refused precondition answers 412 with the schedule's current revision (null when none exists). A definition the planner or the schedule validator refuses answers 422 with its findings; a malformed body, refused inputs or a refused workflow answer 422 with the error envelope.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json put /v1/schedules/{id}","href":"/api-reference/create-or-revision-conditionally-update-one-resident-schedule","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Create requires If-None-Match: *. Update requires the exact ETag in If-Match. Identical lost-response retries are unchanged and retain the revision. A refused precondition answers 412 with the schedule’s current revision (null when none exists). A definition the planner or the schedule validator refuses answers 422 with its findings; a malformed body, refused inputs or a refused workflow answer 422 with the error envelope.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"codeStyling":"system","config":{},"pageMetadata":{"title":"Create or revision-conditionally update one resident schedule","description":"Create requires If-None-Match: *. Update requires the exact ETag in If-Match. Identical lost-response retries are unchanged and retain the revision. A refused precondition answers 412 with the schedule's current revision (null when none exists). A definition the planner or the schedule validator refuses answers 422 with its findings; a malformed body, refused inputs or a refused workflow answer 422 with the error envelope.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json put /v1/schedules/{id}","href":"/api-reference/create-or-revision-conditionally-update-one-resident-schedule","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"description":"Create requires If-None-Match: *. Update requires the exact ETag in If-Match. Identical lost-response retries are unchanged and retain the revision. A refused precondition answers 412 with the schedule's current revision (null when none exists). A definition the planner or the schedule validator refuses answers 422 with its findings; a malformed body, refused inputs or a refused workflow answer 422 with the error envelope.","parameters":["e429c276-5196-4bf6-94db-d54b56b45ada","e653745e-748c-4ff2-ba87-2876831d6ef4"],"requestBody":"dd76812a-420f-4811-9c9e-22caf9fa04fe","responses":{"200":"2fe83322-e957-479d-a299-12714f09ddf9","401":"15c6bffd-274d-4058-a51c-07500a158c34","412":"2dec29cf-0b45-479b-9c71-3e7646d9a616","413":"7a84ec8f-4204-4194-afa5-841b23c42782","415":"7d72bc2d-1cb1-4393-b687-294e892476b8","422":"113dde1a-5c12-46bf-99e8-df9ba97f0d3d","503":"44878130-657c-4a6b-a4aa-85361354c416","507":"ea864bc1-ce56-4e39-b32d-ea38ae99f855"},"summary":"Create or revision-conditionally update one resident schedule","method":"put","type":"path","servers":["bf13c49a-f4bd-4bc0-b74c-64c94051b066"],"security":["b41b47b4-601c-4973-a6a9-e1bf60b20666"],"path":"/v1/schedules/{id}","baseUrlOptions":["http://127.0.0.1"],"title":"Create or revision-conditionally update one resident schedule","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"e429c276-5196-4bf6-94db-d54b56b45ada":{"in":"header","name":"If-None-Match","required":false,"schema":{"const":"*","type":"string","isRequired":false,"uniqueKey":"","typeLabel":"string"}},"e653745e-748c-4ff2-ba87-2876831d6ef4":{"in":"header","name":"If-Match","required":false,"schema":{"maxLength":96,"type":"string","isRequired":false,"uniqueKey":"","typeLabel":"string"}},"c3accac0-a119-4397-896d-07e61d68b1a1":{"in":"path","name":"id","required":true,"schema":{"maxLength":255,"minLength":1,"type":"string","isRequired":true,"uniqueKey":"","typeLabel":"string"}}},"requestBody":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"maxCostUsd":{"exclusiveMinimum":0,"type":"number","isRequired":true,"uniqueKey":"maxCostUsd","typeLabel":"number"},"missed":{"enum":["catch-up","catch-up-once","skip"],"type":"string","isRequired":true,"uniqueKey":"missed","typeLabel":"enum\u003cstring>"},"when":{"oneOf":[{"type":"object","required":["kind","at"],"properties":{"at":{"format":"date-time","type":"string","isRequired":true,"uniqueKey":"when.oneOf.0.at","typeLabel":"string\u003cdate-time>"},"kind":{"const":"once","isRequired":true,"uniqueKey":"when.oneOf.0.kind","typeLabel":"any"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"when.oneOf.0","typeLabel":"object"},{"type":"object","required":["kind","expression"],"properties":{"expression":{"maxLength":4096,"type":"string","isRequired":true,"uniqueKey":"when.oneOf.1.expression","typeLabel":"string"},"kind":{"const":"cadence","isRequired":true,"uniqueKey":"when.oneOf.1.kind","typeLabel":"any"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"when.oneOf.1","typeLabel":"object"}],"isRequired":true,"uniqueKey":"when","typeLabel":"object"},"workflow":{"maxLength":1024,"pattern":"^[^/].*\\.nika$","type":"string","isRequired":true,"uniqueKey":"workflow","typeLabel":"string"},"active":{"type":"boolean","uniqueKey":"active","typeLabel":"boolean"},"afterSkip":{"enum":["next_slot","on_completion"],"type":"string","uniqueKey":"afterSkip","typeLabel":"enum\u003cstring>"},"inputs":{"additionalProperties":{"oneOf":[{"type":"string","uniqueKey":"inputs.additionalProperties.oneOf.0","typeLabel":"string"},{"type":"number","uniqueKey":"inputs.additionalProperties.oneOf.1","typeLabel":"number"},{"type":"boolean","uniqueKey":"inputs.additionalProperties.oneOf.2","typeLabel":"boolean"}],"uniqueKey":"inputs.additionalProperties","typeLabel":"string | number | boolean"},"description":"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.","type":"object","uniqueKey":"inputs","typeLabel":"object"},"jitter":{"enum":["hash"],"type":"string","uniqueKey":"jitter","typeLabel":"enum\u003cstring>"},"maxLatenessSeconds":{"minimum":0,"type":"integer","uniqueKey":"maxLatenessSeconds","typeLabel":"integer"},"overlap":{"enum":["skip","queue","replace"],"type":"string","uniqueKey":"overlap","typeLabel":"enum\u003cstring>"},"pauseReason":{"maxLength":1024,"type":"string","uniqueKey":"pauseReason","typeLabel":"string"},"pauseUntil":{"format":"date","type":"string","uniqueKey":"pauseUntil","typeLabel":"string\u003cdate>"},"tolerance":{"type":"string","uniqueKey":"tolerance","typeLabel":"string"}},"required":["workflow","when","maxCostUsd","missed"],"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"maxCostUsd":123,"when":{"at":"2023-11-07T05:31:56Z","kind":"once"},"workflow":"\u003cstring>","active":true,"inputs":{},"jitter":"hash","maxLatenessSeconds":1,"pauseReason":"\u003cstring>","pauseUntil":"2023-12-25","tolerance":"\u003cstring>"}}},"exampleType":"generated"}},"required":true,"exampleType":"generated"},"responses":{"2fe83322-e957-479d-a299-12714f09ddf9":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"applied":{"const":true,"type":"boolean","isRequired":true,"uniqueKey":"applied","typeLabel":"boolean"},"changed":{"type":"boolean","isRequired":true,"uniqueKey":"changed","typeLabel":"boolean"},"status":{"additionalProperties":true,"description":"Normalized definition, origin, distinct schedule revision, active/pause state, due verdict, bounded next slots with shift evidence, earliest wake hint, and last durable decision.","type":"object","isRequired":true,"uniqueKey":"status","typeLabel":"object"}},"required":["applied","changed","status"],"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"applied":true,"changed":true,"status":{}}}},"exampleType":"generated"}},"description":"Applied or unchanged","headers":{"ETag":{"schema":{"type":"string"}}},"exampleType":"generated"},"15c6bffd-274d-4058-a51c-07500a158c34":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"error":{"additionalProperties":false,"properties":{"code":{"type":"string","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"}},"required":["code","message"],"type":"object","isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["error"],"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"\u003cstring>","message":"\u003cstring>"}}}},"exampleType":"generated"}},"description":"Error envelope","exampleType":"generated"},"2dec29cf-0b45-479b-9c71-3e7646d9a616":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"error":{"additionalProperties":false,"properties":{"code":{"const":"schedule_precondition_failed","type":"string","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"currentRevision":{"oneOf":[{"type":"string","pattern":"^sha256:[0-9a-f]{64}$","isRequired":true,"uniqueKey":"error.currentRevision.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"error.currentRevision.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"error.currentRevision","typeLabel":"string | null"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"}},"required":["code","message","currentRevision"],"type":"object","isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["error"],"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"schedule_precondition_failed","currentRevision":"\u003cstring>","message":"\u003cstring>"}}}},"exampleType":"generated"}},"description":"Precondition refused; carries the current revision","headers":{"ETag":{"description":"The current revision, when one exists","schema":{"type":"string"}}},"exampleType":"generated"},"7a84ec8f-4204-4194-afa5-841b23c42782":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"error":{"additionalProperties":false,"properties":{"code":{"type":"string","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"}},"required":["code","message"],"type":"object","isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["error"],"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"\u003cstring>","message":"\u003cstring>"}}}},"exampleType":"generated"}},"description":"Error envelope","exampleType":"generated"},"7d72bc2d-1cb1-4393-b687-294e892476b8":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"error":{"additionalProperties":false,"properties":{"code":{"type":"string","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"}},"required":["code","message"],"type":"object","isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["error"],"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"\u003cstring>","message":"\u003cstring>"}}}},"exampleType":"generated"}},"description":"Error envelope","exampleType":"generated"},"113dde1a-5c12-46bf-99e8-df9ba97f0d3d":{"content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["findings"],"properties":{"findings":{"items":{"additionalProperties":false,"properties":{"code":{"minLength":1,"type":"string","isRequired":true,"uniqueKey":"oneOf.0.findings.items.[INDEX].code","typeLabel":"string"},"detail":{"type":"string","isRequired":true,"uniqueKey":"oneOf.0.findings.items.[INDEX].detail","typeLabel":"string"}},"required":["code","detail"],"type":"object","uniqueKey":"oneOf.0.findings.items.[INDEX]","typeLabel":"object"},"minItems":1,"type":"array","isRequired":true,"uniqueKey":"oneOf.0.findings","typeLabel":"object[]"}},"additionalProperties":false,"uniqueKey":"oneOf.0","typeLabel":"object"},{"type":"object","required":["error"],"properties":{"error":{"additionalProperties":false,"properties":{"code":{"type":"string","isRequired":true,"uniqueKey":"oneOf.1.error.code","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"oneOf.1.error.message","typeLabel":"string"}},"required":["code","message"],"type":"object","isRequired":true,"uniqueKey":"oneOf.1.error","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"oneOf.1","typeLabel":"object"}],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"findings":[{"code":"\u003cstring>","detail":"\u003cstring>"}]}}},"exampleType":"generated"}},"description":"Refused definition: its findings, or the error envelope","exampleType":"generated"},"44878130-657c-4a6b-a4aa-85361354c416":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"error":{"additionalProperties":false,"properties":{"code":{"type":"string","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"}},"required":["code","message"],"type":"object","isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["error"],"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"\u003cstring>","message":"\u003cstring>"}}}},"exampleType":"generated"}},"description":"Error envelope","exampleType":"generated"},"ea864bc1-ce56-4e39-b32d-ea38ae99f855":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"error":{"additionalProperties":false,"properties":{"code":{"type":"string","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"}},"required":["code","message"],"type":"object","isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["error"],"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"\u003cstring>","message":"\u003cstring>"}}}},"exampleType":"generated"}},"description":"Durable schedule capacity exhausted","exampleType":"generated"}},"security":{"b41b47b4-601c-4973-a6a9-e1bf60b20666":{"bearerAuth":{"description":"Exactly one Authorization: Bearer value from the token file","scheme":"bearer","type":"http","scopes":[],"schemeName":"bearerAuth"}}},"servers":{"bf13c49a-f4bd-4bc0-b74c-64c94051b066":{"url":"http://127.0.0.1"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"description":"Exactly one Authorization: Bearer value from the token file","scheme":"bearer","type":"http","scopes":[],"schemeName":"bearerAuth"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Exactly one Authorization: Bearer value from the token file","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"bearerAuth","name":"Authorization"}],"title":"bearerAuth"}]},"originalFileLocation":"api-reference/openapi.json"},"subdomain":"supernovae-acdf3706","siteName":"Nika","title":"Create or revision-conditionally update one resident schedule - Nika","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-10T22:41:12.716Z","originalFileLocation":"api-reference/create-or-revision-conditionally-update-one-resident-schedule.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"dark\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Create requires If-None-Match: *. Update requires the exact ETag in If-Match. Identical lost-response retries are unchanged and retain the revision. A refused precondition answers 412 with the schedule\u0026#x27;s current revision (null when none exists). A definition the planner or the schedule validator refuses answers 422 with its findings; a malformed body, refused inputs or a refused workflow answer 422 with the error envelope.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Nika\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/supernovae-acdf3706/nNpvwcCdepgiS-MX/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/supernovae-acdf3706/nNpvwcCdepgiS-MX/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/supernovae-acdf3706/nNpvwcCdepgiS-MX/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/supernovae-acdf3706/nNpvwcCdepgiS-MX/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/supernovae-acdf3706/nNpvwcCdepgiS-MX/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/supernovae-acdf3706/nNpvwcCdepgiS-MX/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/supernovae-acdf3706/nNpvwcCdepgiS-MX/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/supernovae-acdf3706/nNpvwcCdepgiS-MX/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/supernovae-acdf3706/nNpvwcCdepgiS-MX/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Create or revision-conditionally update one resident schedule - Nika\">\u003cmeta data-mint-head property=\"og:description\" content=\"Create requires If-None-Match: *. Update requires the exact ETag in If-Match. Identical lost-response retries are unchanged and retain the revision. A refused precondition answers 412 with the schedule\u0026#x27;s current revision (null when none exists). A definition the planner or the schedule validator refuses answers 422 with its findings; a malformed body, refused inputs or a refused workflow answer 422 with the error envelope.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Nika\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.nika.sh/api-reference/create-or-revision-conditionally-update-one-resident-schedule\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://docs.nika.sh/images/og-card.png\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Create or revision-conditionally update one resident schedule - Nika\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Create requires If-None-Match: *. Update requires the exact ETag in If-Match. Identical lost-response retries are unchanged and retain the revision. A refused precondition answers 412 with the schedule\u0026#x27;s current revision (null when none exists). A definition the planner or the schedule validator refuses answers 422 with its findings; a malformed body, refused inputs or a refused workflow answer 422 with the error envelope.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://docs.nika.sh/images/og-card.png\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/supernovae-acdf3706/nNpvwcCdepgiS-MX/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Nika\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#2f6bff\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.nika.sh/api-reference/create-or-revision-conditionally-update-one-resident-schedule\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/create-or-revision-conditionally-update-one-resident-schedule.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.nika.sh/#organization\",\"name\":\"Nika\",\"url\":\"https://docs.nika.sh\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/supernovae-acdf3706/3ObRrFNWymK8fsLG/images/logo-light.svg?fit=max\u0026auto=format\u0026n=3ObRrFNWymK8fsLG\u0026q=85\u0026s=73b2f60862ed01f97cfa045151df991e\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.nika.sh#website\",\"name\":\"Nika\",\"url\":\"https://docs.nika.sh\",\"publisher\":{\"@id\":\"https://docs.nika.sh/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.nika.sh/api-reference/create-or-revision-conditionally-update-one-resident-schedule#webpage\",\"url\":\"https://docs.nika.sh/api-reference/create-or-revision-conditionally-update-one-resident-schedule\",\"name\":\"Create or revision-conditionally update one resident schedule\",\"description\":\"Create requires If-None-Match: *. Update requires the exact ETag in If-Match. Identical lost-response retries are unchanged and retain the revision. A refused precondition answers 412 with the schedule's current revision (null when none exists). A definition the planner or the schedule validator refuses answers 422 with its findings; a malformed body, refused inputs or a refused workflow answer 422 with the error envelope.\",\"dateModified\":\"2026-11-10T22:41:12.716Z\",\"isPartOf\":{\"@id\":\"https://docs.nika.sh#website\"},\"breadcrumb\":{\"@id\":\"https://docs.nika.sh/api-reference/create-or-revision-conditionally-update-one-resident-schedule#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.nika.sh/api-reference/create-or-revision-conditionally-update-one-resident-schedule#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Remote API\",\"item\":\"https://docs.nika.sh/sdk/remote/serve-quickstart\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"API Reference\",\"item\":\"https://docs.nika.sh/api-reference/public-process-liveness\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Create or revision-conditionally update one resident schedule\",\"item\":\"https://docs.nika.sh/api-reference/create-or-revision-conditionally-update-one-resident-schedule\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.nika.sh/api-reference/create-or-revision-conditionally-update-one-resident-schedule#apireference\",\"headline\":\"Create or revision-conditionally update one resident schedule\",\"name\":\"Create or revision-conditionally update one resident schedule\",\"description\":\"Create requires If-None-Match: *. Update requires the exact ETag in If-Match. Identical lost-response retries are unchanged and retain the revision. A refused precondition answers 412 with the schedule's current revision (null when none exists). A definition the planner or the schedule validator refuses answers 422 with its findings; a malformed body, refused inputs or a refused workflow answer 422 with the error envelope.\",\"url\":\"https://docs.nika.sh/api-reference/create-or-revision-conditionally-update-one-resident-schedule\",\"mainEntityOfPage\":{\"@id\":\"https://docs.nika.sh/api-reference/create-or-revision-conditionally-update-one-resident-schedule#webpage\"},\"image\":\"https://docs.nika.sh/images/og-card.png\",\"dateModified\":\"2026-11-10T22:41:12.716Z\",\"publisher\":{\"@id\":\"https://docs.nika.sh/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.nika.sh#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Nika\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Nika\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api-reference/create-or-revision-conditionally-update-one-resident-schedule.md","siteName":"Nika","nav":{"global":null,"tabs":[{"tab":"Guide","icon":"book-open","pages":[{"title":"Guide","href":"/introduction"}]},{"tab":"SDK","icon":"code","groups":[{"group":"Overview","pages":[{"title":"TypeScript SDK","sidebarTitle":"Overview","icon":"code","href":"/sdk/overview"},{"title":"How the SDK works","sidebarTitle":"How it works","icon":"diagram-project","href":"/sdk/how-it-works"}]},{"group":"Start","pages":[{"title":"TypeScript quickstart","sidebarTitle":"Quickstart","icon":"play","href":"/sdk/start/quickstart"},{"title":"Project setup","sidebarTitle":"Project setup","icon":"folder-tree","href":"/sdk/start/project-setup"}]},{"group":"Project","pages":[{"title":"nika.yaml project file","sidebarTitle":"nika.yaml","icon":"file-code","href":"/sdk/project/nika-yaml"},{"title":"CWD and monorepos","sidebarTitle":"CWD and monorepos","icon":"folder-tree","href":"/sdk/project/cwd-and-monorepos"},{"title":"Arm registry","sidebarTitle":"Arm registry","icon":"clock","href":"/sdk/project/arm-registry"},{"title":"Project policy ladders","sidebarTitle":"Policy ladders","icon":"stairs","href":"/sdk/project/policy-ladders"},{"title":"Project runtime state","sidebarTitle":"Runtime state","icon":"database","href":"/sdk/project/runtime-state"}]},{"group":"Local API","pages":[{"title":"Local client","sidebarTitle":"Local client","icon":"terminal","href":"/sdk/local/client"},{"title":"Check before admission","sidebarTitle":"Check","icon":"list-check","href":"/sdk/local/check-and-plan"},{"title":"Run and cancel","sidebarTitle":"Run and cancel","icon":"circle-play","href":"/sdk/local/run-and-cancel"},{"title":"Compile a workflow","sidebarTitle":"Compile","icon":"wand-magic-sparkles","href":"/sdk/local/compile"},{"title":"Test and trace","sidebarTitle":"Test and trace","icon":"vial-circle-check","href":"/sdk/local/test-and-trace"}]},{"group":"Runtime","pages":[{"title":"Results and settlement","sidebarTitle":"Results","icon":"flag-checkered","href":"/sdk/runtime/results"},{"title":"Run events","sidebarTitle":"Run events","icon":"wave-pulse","href":"/sdk/runtime/events"},{"title":"Errors","sidebarTitle":"Errors","icon":"triangle-exclamation","href":"/sdk/runtime/errors"},{"title":"Receipts and verification","sidebarTitle":"Receipts","icon":"link","href":"/sdk/runtime/receipts"},{"title":"Spend caps","sidebarTitle":"Spend caps","icon":"scale-balanced","href":"/sdk/runtime/spend"},{"title":"Permits and admission","sidebarTitle":"Permits","icon":"shield-halved","href":"/sdk/runtime/permits"}]},{"group":"Remote API","pages":[{"title":"Server quickstart","sidebarTitle":"Server quickstart","icon":"server","href":"/sdk/remote/serve-quickstart"},{"title":"Remote client","sidebarTitle":"Remote client","icon":"satellite-dish","href":"/sdk/remote/client"},{"title":"Remote jobs","sidebarTitle":"Jobs","icon":"list-check","href":"/sdk/remote/jobs"},{"title":"SSE streaming","sidebarTitle":"SSE streaming","icon":"wave-pulse","href":"/sdk/remote/streaming"},{"title":"Schedules","sidebarTitle":"Schedules","icon":"calendar","href":"/sdk/remote/schedules"},{"title":"Outputs and artifacts","sidebarTitle":"Outputs and artifacts","icon":"box-archive","href":"/sdk/remote/artifacts"},{"title":"Workflow registry","sidebarTitle":"Workflow registry","icon":"folder-open","href":"/sdk/remote/workflows"},{"title":"Application webhooks","sidebarTitle":"Application webhooks","icon":"webhook","href":"/sdk/remote/webhooks"},{"group":"API Reference","pages":[{"title":"Public process liveness","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /health","href":"/api-reference/public-process-liveness"},{"title":"What the sessions of a workflow's declared ACP route offer now","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/access-offers/{name}","href":"/api-reference/what-the-sessions-of-a-workflows-declared-acp-route-offer-now"},{"title":"Judge a workflow without creating a job — by served name, or as immutable snapshot bytes","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/check","href":"/api-reference/judge-a-workflow-without-creating-a-job-—-by-served-name-or-as-immutable-snapshot-bytes"},{"title":"Author a candidate workflow without running it (stateless · source-only)","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/compile","href":"/api-reference/author-a-candidate-workflow-without-running-it-stateless-·-source-only"},{"title":"Admit a workflow as a durable job — by served name, or as immutable snapshot bytes","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/jobs","href":"/api-reference/admit-a-workflow-as-a-durable-job-—-by-served-name-or-as-immutable-snapshot-bytes"},{"title":"Job identity and status","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/jobs/{id}","href":"/api-reference/job-identity-and-status"},{"title":"The artifacts a settled job's sealed journal records","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/jobs/{id}/artifacts","href":"/api-reference/the-artifacts-a-settled-jobs-sealed-journal-records"},{"title":"Stream one artifact's bytes, verified against its journaled SHA-256","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/jobs/{id}/artifacts/{name}","href":"/api-reference/stream-one-artifacts-bytes-verified-against-its-journaled-sha-256"},{"title":"Request cancellation or replay an ended observation","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/jobs/{id}/cancel","href":"/api-reference/request-cancellation-or-replay-an-ended-observation"},{"title":"Job event SSE","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/jobs/{id}/events","href":"/api-reference/job-event-sse"},{"title":"Status only; diagnosis lives on GET /v1/jobs/{id} and SSE","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/jobs/{id}/status","href":"/api-reference/status-only;-diagnosis-lives-on-get-v1jobs-and-sse"},{"title":"Verify the job's trace journal","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/jobs/{id}/trace/verify","href":"/api-reference/verify-the-jobs-trace-journal"},{"title":"This document","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/openapi.json","href":"/api-reference/this-document"},{"title":"Read one declarative resident schedule","description":null,"deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/schedules/{id}","href":"/api-reference/read-one-declarative-resident-schedule"},{"title":"Create or revision-conditionally update one resident schedule","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json put /v1/schedules/{id}","href":"/api-reference/create-or-revision-conditionally-update-one-resident-schedule"},{"title":"Contained workflow names","description":null,"deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/workflows","href":"/api-reference/contained-workflow-names"},{"title":"Workflow metadata without source bytes","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/workflows/{name}","href":"/api-reference/workflow-metadata-without-source-bytes"}]}]},{"group":"Operations","pages":[{"title":"CI gate","sidebarTitle":"CI gate","icon":"shield-check","href":"/sdk/operations/ci"},{"title":"Server surfaces","sidebarTitle":"Server surfaces","icon":"server","href":"/sdk/operations/server-surfaces"},{"title":"Resident server","sidebarTitle":"Resident server","icon":"server","href":"/sdk/operations/resident-server"},{"title":"Server runbook","sidebarTitle":"Server runbook","icon":"clipboard-check","href":"/sdk/operations/server-runbook"},{"title":"OS scheduler bridge","sidebarTitle":"OS schedulers","icon":"calendar","href":"/sdk/operations/os-schedulers"},{"title":"Deployment topologies","sidebarTitle":"Deployment topologies","icon":"sitemap","href":"/sdk/operations/deployment-topologies"},{"title":"Security boundary","sidebarTitle":"Security boundary","icon":"shield","href":"/sdk/operations/security"}]},{"group":"Reference","pages":[{"title":"SDK configuration","sidebarTitle":"Configuration","icon":"sliders","href":"/sdk/reference/configuration"},{"title":"SDK method index","sidebarTitle":"Method index","icon":"list","href":"/sdk/reference/methods"},{"title":"SDK type index","sidebarTitle":"Type index","icon":"brackets-curly","href":"/sdk/reference/types"}]}]},{"tab":"Examples","icon":"rocket","pages":[{"title":"Examples","href":"/examples/overview"}]},{"tab":"Architecture","icon":"layer-group","pages":[{"title":"Architecture","href":"/architecture/layers"}]},{"tab":"Reference","icon":"code","pages":[{"title":"Reference","href":"/reference/yaml-syntax"}]},{"tab":"Changelog","icon":"clock-rotate-left","pages":[{"title":"Changelog","href":"/changelog/releases"}]}]},"basePath":"","title":"Create or revision-conditionally update one resident schedule - Nika","buildId":"dpl_596ePT575z4qnAFksq1biRW97aLY","deploymentId":"dpl_596ePT575z4qnAFksq1biRW97aLY","dynamics":["10e4515597","c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["BannerMarkdown-6DXXLlfN.js","dist-CmKHfscc.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","clsx-C3kuh_dz.js","html-void-elements-mCSPHezU.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","OpenApiReferenceProvider-C9Wu0MeN.js","utils-jWgu-6Qf.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-DBD8f9qn.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-BGuX1ui5.js","snippetPresets-Evy63nQB.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-BQHO1lnV.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-B6C8m-t_.js","shallow-BG4cT0fH.js","getApiPlaygroundDisplay-CgEPrE-D.js","CodeSnippet-CU8JyZ9N.js","CodeSnippets-BnxHU32T.js","Page-D6S0Yh6q.js","getPastedJson-CwiYOonh.js","icon-DYDpWmDf.js","MethodPill-C-J-l7_c.js","DuplicateIcon-B6ARwg9w.js","createIcon-Dsv4MtDq.js","DynamicMarkdown-CtasenyM.js","SectionHeading-YNcgYwjB.js","axios-vUo_bRtp.js","Markdown-CwLx6PAg.js","AssistantPageLink-U3mI6Ljh.js"]}