{"uid":"cap_bj84gOjOS-SpHKDuw18H-","slug":"scheduler-withzero-xyz-clone-task-spec-into-fresh-template-17a77676","name":"Clone Task Spec into Fresh Template","description":"Clone an existing task spec into a fresh template (env values masked). 📖 Full guide: https://scheduler.withzero.xyz/llms.txt","url":"https://scheduler.withzero.xyz/api/v1/tasks/clone","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["from_task_id"],"properties":{"from_task_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)$","description":"Source task to clone the spec from. May be deleted or completed."}},"additionalProperties":false},"responseSchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["runtime","source","entrypoint","dependencies","llm","artifacts","max_runtime_sec","max_sibling_calls","notify_email","end_at"],"properties":{"env":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string"}},"llm":{"anyOf":[{},{"type":"null"}]},"end_at":{"anyOf":[{"type":"string"},{"type":"null"}]},"source":{"type":"string"},"runtime":{"type":"string"},"schedule":{"type":"object","required":["cron","timezone"],"properties":{"cron":{"type":"string"},"timezone":{"type":"string"}},"additionalProperties":false},"artifacts":{"anyOf":[{},{"type":"null"}]},"tool_list":{"type":"array","items":{"type":"string"}},"entrypoint":{"type":"string"},"billing_rail":{"enum":["direct","zeroclick","account"],"type":"string"},"dependencies":{"anyOf":[{},{"type":"null"}]},"notify_email":{"anyOf":[{"type":"string"},{"type":"null"}]},"max_runtime_sec":{"type":"number"},"max_sibling_calls":{"type":"number"},"max_amount_usdc_micros":{"type":"string"}},"additionalProperties":false},"example":null,"exampleRequest":null,"tags":[],"displayCostAmount":"0","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"proven_free","priceSource":"registry","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"1.00","reviews":0,"stars":null,"state":"rated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"free","summary":"Free","primary":null,"accepted":[]},"paymentMethods":[],"brandName":"scheduler.withzero.xyz","brandSlug":"scheduler-withzero-xyz-mpp","brandBaseUrl":"https://scheduler.withzero.xyz","brandDocsUrl":null,"whatItDoes":"Clones an existing task's spec (schedule, runtime, source, entrypoint, etc.) into a new template with environment variable values masked.","exampleAgentPrompt":"Clone the cron task with ID a3f2c1b0-1234-4abc-ab12-000000000001 into a fresh template so I can reuse its schedule and runtime settings — keep the env values masked.","exampleUseCases":null,"resultDescription":"Returns a task spec template object containing the source task's schedule (cron expression and timezone), runtime, source, entrypoint, dependencies, tool_list, llm config, max_runtime_sec, max_sibling_calls, max_amount_usdc_micros, notify_email, and end_at. The env field is included but with values masked/redacted for security.","failureModes":["404 if from_task_id does not exist or is not accessible","400 if from_task_id is not a valid UUID format","401/403 if authentication or ownership proof is missing or invalid","500 if internal cloning or KMS operation fails"],"whenToPreferThis":"Use this endpoint when you want to reuse the configuration of an existing task (including deleted or completed ones) as a starting point for a new task, without having to re-specify all fields. Prefer this over manually constructing a task spec when you know a good reference task already exists and want to safely copy its settings while masking sensitive env values.","instructions":"# Clone Task — fresh template from an existing spec\n\n## Workflow\n- Use when you need to change an immutable field PATCH can't touch (PATCH /tasks/{id} only edits notify_email/end_at/tool_list).\n- The clone is a template, not a live task — create it for real via POST /api/v1/tasks (pay a new deposit).\n\n## Contract\n- env values are masked in the clone — re-supply secrets via PUT /api/v1/tasks/{id}/env after creating.","reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":3,"lastUsedAt":"2026-07-20T13:13:38.230Z","lastSuccessfullyRanAt":"2026-07-20T13:13:38.230Z","lastHealthCheckAt":"2026-09-14T06:37:01.035Z","isFirstParty":true}