{"uid":"cap_6zDEDcxRxehGBfOMtVf_c","slug":"scheduler-withzero-xyz-disable-task-webhook-91d1d0c7","name":"Disable Task Webhook","description":"Disable the task webhook (clears the secret). Idempotent. 📖 Full guide: https://scheduler.withzero.xyz/llms.txt","url":"https://scheduler.withzero.xyz/api/v1/tasks/{id}/webhook","method":"DELETE","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","properties":{},"description":"Empty body. Disables the task webhook (clears the secret).","additionalProperties":false},"responseSchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["enabled"],"properties":{"enabled":{"type":"boolean"}},"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":"0.00","reviews":0,"stars":null,"state":"unrated"},"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":"Deletes and clears the webhook secret for a scheduled task, disabling webhook delivery idempotently.","exampleAgentPrompt":"Disable the webhook on my zero scheduler task with ID abc-123 — I want to clear the secret and stop any further webhook deliveries.","exampleUseCases":null,"resultDescription":"Returns a JSON object with a single boolean field `enabled` set to false, confirming the webhook has been disabled and its secret cleared.","failureModes":["Task ID not found — 404 not found response","Unauthorized caller — 401 or 403 if proof of ownership fails","Invalid task ID format — 400 bad request","Webhook was already disabled but call still succeeds (idempotent — no error)"],"whenToPreferThis":"Use this endpoint when you need to stop webhook deliveries for a specific scheduled task and invalidate the existing webhook secret. Since it is idempotent, it is safe to call even if the webhook is already disabled. Prefer this over simply ignoring the webhook — it actively clears the secret so no further authenticated webhook POSTs can be made.","instructions":"# Disable Webhook\n\n## Contract\n- Clears the webhook secret. Idempotent. Re-enable (with a new secret) via PUT /api/v1/tasks/{id}/webhook.","reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":1,"lastUsedAt":"2026-07-28T22:30:15.374Z","lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-11T06:41:39.826Z","isFirstParty":true}