{"uid":"cap_ARvhN_dmdG8D90zeVviN-","slug":"scheduler-withzero-xyz-enable-or-rotate-task-webhook-secret-e257468a","name":"Enable or Rotate Task Webhook Secret","description":"Enable or rotate the task webhook secret (returned ONCE). Present it as Authorization: Bearer to POST /tasks/:id/webhook to trigger a run without a wallet. 📖 Full guide: https://scheduler.withzero.xyz/llms.txt","url":"https://scheduler.withzero.xyz/api/v1/tasks/{id}/webhook","method":"PUT","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","properties":{},"description":"Empty body. Enables or rotates the task webhook secret.","additionalProperties":false},"responseSchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["secret","enabled"],"properties":{"secret":{"type":"string","description":"The webhook secret — shown ONCE. Present it as `Authorization: Bearer <secret>` to POST /api/v1/tasks/:id/webhook."},"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.95","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":"Generates or rotates a one-time-shown webhook secret for a scheduled task, enabling walletless trigger authentication via Bearer token.","exampleAgentPrompt":"Enable the webhook trigger for my scheduler task abc-123 so I can fire it from an external service without needing a wallet — give me the new bearer secret.","exampleUseCases":[{"title":"Rotate compromised webhook secret for task","prompt":"My task webhook secret got exposed in a log file — I need to rotate it immediately and get the new bearer token to give my external service."},{"title":"Set up webhook authentication on new task","prompt":"I just created a scheduled task and want to enable webhook triggering so my monitoring system can kick off runs without going through the wallet flow — set it up and give me the bearer secret."},{"title":"Generate bearer token for third-party integration","prompt":"I'm integrating with an external service that needs to trigger my cron job via HTTP — generate me a webhook secret and tell me how to use it as a Bearer token in the request."}],"resultDescription":"Returns a one-time-visible webhook secret string and a boolean 'enabled' flag. The secret must be captured immediately as it will not be shown again; it is used as a Bearer token in the Authorization header when calling POST /tasks/:id/webhook to trigger runs without a wallet.","failureModes":["Task ID not found — 404 if the specified task does not exist or is not owned by the caller","Unauthorized — 401/403 if the caller lacks proof of task ownership","Secret already shown and not re-retrievable — rotating again invalidates prior secret","Service unavailable — 503 if the scheduler backend is unreachable"],"whenToPreferThis":"Use this endpoint when you need to allow an external system or agent to trigger a specific scheduled task via HTTP POST without requiring a crypto wallet or MPP payment flow. It is the correct choice when setting up webhook-based integrations, rotating a compromised secret, or enabling the webhook feature for the first time on a task.","instructions":"# Enable / Rotate Webhook Secret\n\n## Workflow\n- Disable later: DELETE /api/v1/tasks/{id}/webhook\n\n## Contract\n- Secret is returned ONCE — store it now. Present it as `Authorization: Bearer <secret>` to POST /tasks/{id}/webhook to trigger a run WITHOUT a wallet (for external webhook sources).","reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":59,"lastUsedAt":"2026-07-28T22:30:15.385Z","lastSuccessfullyRanAt":"2026-07-23T21:35:51.508Z","lastHealthCheckAt":"2026-09-11T06:30:16.705Z","isFirstParty":true}