API Reference

Workers

Webhooks

Copy Markdown

Open in Claude

Open in ChatGPT

Open in Cursor

---

Copy Markdown

View as Markdown

Regenerate a worker webhook token

$ handinger workers:webhooks regenerate-token

POST/api/workers/{workerId}/webhook/regenerate-token

Issue a new shared token for the webhook, invalidating the previous one. The webhook URL is preserved. Only the worker creator can regenerate the token.

ParametersExpand Collapse

--worker-id: string

Worker id returned by the create worker endpoint.

ReturnsExpand Collapse

webhook: object { token, url }

token: string

Shared secret sent in the X-Handinger-Token header on each delivery. null when no webhook is configured.

url: string

HTTPS endpoint that receives webhook deliveries when a task completes. null when no webhook is configured.

Regenerate a worker webhook token

CLI Tool

HTTP

TypeScript

Python

Go

Ruby

CLI Tool

handinger workers:webhooks regenerate-token \
  --api-key 'My API Key' \
  --worker-id t_org_123_w_01HZY2ZJQ8G7K42W2D7WF6V4GM

200 example

{
  "token": "whk_01HZY31W2SZJ8MJ2FQTR3M1K9D",
  "url": "https://example.com/handinger-webhook"
}

Returns Examples

200 example

{
  "token": "whk_01HZY31W2SZJ8MJ2FQTR3M1K9D",
  "url": "https://example.com/handinger-webhook"
}