{"uid":"cap_S6t3Z4tJr-ttl63UXtBMj","slug":"agents-withzero-xyz-enable-or-rotate-task-webhook-secret-045d6432","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://agents.withzero.xyz/api/v1/scheduler/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.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_IeixgiqQArUDOqE3UeCKh","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":"Generates or rotates the webhook secret for a scheduled task, enabling the task to be triggered via HTTP POST without a wallet.","exampleAgentPrompt":"Enable the webhook trigger for my scheduled task abc123 so I can fire it from an external service without needing a wallet — give me the bearer secret.","exampleUseCases":[{"title":"External CI pipeline triggering a task","prompt":"I want to trigger my task def456 from my GitHub Actions workflow without using a wallet — can you enable the webhook secret for it so I can use it as a Bearer token?"},{"title":"Rotating a compromised webhook secret","prompt":"The webhook secret for task xyz789 may have been leaked — can you rotate it right now and give me the new one so I can update my integration?"},{"title":"Setting up no-wallet task automation","prompt":"I have a scheduled task with ID task-0042 and I need to allow a third-party service to trigger it via HTTP — please generate a webhook secret for it."}],"resultDescription":"Returns a one-time-visible webhook secret string and a boolean indicating the webhook is enabled. The secret must be saved immediately as it will not be shown again; it should be used as an Authorization: Bearer header when POSTing to the task's webhook endpoint.","failureModes":["Task ID not found — 404 if the specified task does not exist or belongs to another caller","Unauthorized — 401 if the caller's proof does not match the task owner","Secret lost permanently — if the caller does not save the returned secret, it cannot be retrieved again and must be rotated","Service error — 500 if the rotation fails server-side"],"whenToPreferThis":"Use this endpoint when you need to allow an external system, CI pipeline, or automation tool to trigger a WithZero scheduled task via HTTP POST without requiring a crypto wallet or payment header. It is the right choice when setting up webhook-based integrations for the first time, or when rotating a potentially compromised secret.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-11T06:30:19.222Z","isFirstParty":true}