{"uid":"cap_7C2HYXeRBWs5pmrNdLCtZ","slug":"agents-withzero-xyz-withzero-scheduler-task-update-patch-3da7f6c7","name":"WithZero Scheduler Task Update (PATCH)","description":"Update notify_email, end_at, or tool_list (additions only). 📖 Full guide: https://scheduler.withzero.xyz/llms.txt","url":"https://agents.withzero.xyz/api/v1/scheduler/tasks/{id}","method":"PATCH","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"end_at":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"tool_list":{"type":"array","items":{"type":"string"}},"notify_email":{"anyOf":[{"type":"string","format":"email","pattern":"^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"},{"type":"null"}]},"max_runtime_sec":{"type":"integer","maximum":900,"description":"Raise the per-run wall-clock cap in seconds (max 900). Raises only — lowering forces clone+recreate. 409 RUN_IN_FLIGHT while a run is claimed/running; retry after it finishes. Raising it raises the per-run ceiling reservation — top up if the balance drops below one ceiling.","exclusiveMinimum":0},"max_sibling_spend_micros":{"type":"string","pattern":"^[1-9]\\d*$","description":"Raise the per-run sibling-spend ceiling (USDC micros; string, or number up to 2^53-1). Raises only — lowering forces clone+recreate."}},"description":"Only `notify_email`, `end_at`, `tool_list` (additions only), `max_sibling_spend_micros` (raises only), and `max_runtime_sec` (raises only, no run in flight) may be patched. All other fields are immutable.","additionalProperties":false},"responseSchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["id","tool_list","max_sibling_spend_micros","max_runtime_sec","estimated_ceiling_micros","notify_email","end_at"],"properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"end_at":{"anyOf":[{"type":"string"},{"type":"null"}]},"tool_list":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}]},"notify_email":{"anyOf":[{"type":"string"},{"type":"null"}]},"max_runtime_sec":{"type":"integer","maximum":9007199254740991,"minimum":-9007199254740991},"estimated_ceiling_micros":{"type":"string"},"max_sibling_spend_micros":{"anyOf":[{"type":"string"},{"type":"null"}]}},"additionalProperties":false},"example":null,"exampleRequest":null,"tags":[],"displayCostAmount":"0.000000","displayCostAsset":"USD","priceDynamic":false,"priceHint":null,"priceStatus":"unknown_unparsed","priceSource":"registry","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"unknown","summary":"price unknown","primary":{"kind":"unknown","protocol":"mpp","network":"tempo","amountUsd":null,"per":"call","confidence":"unknown"},"accepted":[{"kind":"unknown","protocol":"mpp","network":"tempo","amountUsd":null,"per":"call","confidence":"unknown"}]},"paymentMethods":[{"uid":"pm_-ZKtxDhk8gkfKc2mfz-_j","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"0.000000","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":"agents.withzero.xyz","brandSlug":"agents-withzero-xyz-mpp","brandBaseUrl":"https://agents.withzero.xyz","brandDocsUrl":null,"whatItDoes":"Partially updates a scheduled task's notification email, expiry time, allowed tool list (additions only), or raises runtime/spend ceilings","exampleAgentPrompt":"Update my WithZero scheduler task abc123 to notify me at alerts@mycompany.com when it runs, add the 'web_search' tool to its tool list, and extend its end date to 2025-12-31T23:59:59Z.","exampleUseCases":[{"title":"Add notification email to a running task","prompt":"My scheduled task on WithZero (ID: e3f1a2b4-...) doesn't have a notification email set — can you add ops@myteam.com so we get an alert every time it runs?"},{"title":"Extend task expiry deadline","prompt":"My recurring WithZero task is set to expire on June 30th but I need it to keep running through the end of the year — can you push the end_at to 2025-12-31T23:59:59Z?"},{"title":"Raise runtime ceiling for long-running agent","prompt":"My WithZero scheduler task sometimes hits the runtime limit — can you raise the max_runtime_sec to 600 seconds so it has more headroom to finish?"}],"resultDescription":"Returns the updated task object including its UUID, current tool_list, max_sibling_spend_micros, max_runtime_sec, estimated_ceiling_micros, notify_email, and end_at. Immutable fields (like the task spec, env, schedule) are not returned or modified.","failureModes":["409 RUN_IN_FLIGHT — cannot raise max_runtime_sec while a run is claimed or in progress; retry after the run completes","400 validation error — attempting to lower max_runtime_sec or max_sibling_spend_micros (raises only)","400 validation error — attempting to remove tools from tool_list (additions only)","400 invalid email format for notify_email","400 invalid datetime format for end_at","404 task not found or caller lacks ownership proof","409 conflict if attempting to patch immutable fields"],"whenToPreferThis":"Use this endpoint when you need to modify a live WithZero scheduled task in-place without recreating it — specifically to add notification email, extend expiry, append tools, or raise runtime/spend ceilings. If you need to lower any ceiling or change immutable fields (schedule, env, base spec), you must clone and recreate the task instead. Prefer this over delete+recreate when the task is active and you want to preserve its ID, audit trail, and existing configuration.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T12:40:45.145Z","isFirstParty":true}