Skip to content
Handinger
Get started
API Reference
Workers
Webhooks

Regenerate a worker webhook token

workers.webhooks.regenerate_token(strworker_id) -> Webhook
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: str
ReturnsExpand Collapse
class Webhook: …
token: Optional[str]

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

url: Optional[str]

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

Regenerate a worker webhook token

import os
from handinger import Handinger

client = Handinger(
    api_key=os.environ.get("HANDINGER_API_KEY"),  # This is the default and can be omitted
)
webhook = client.workers.webhooks.regenerate_token(
    "t_org_123_w_01HZY2ZJQ8G7K42W2D7WF6V4GM",
)
print(webhook.token)
{
  "token": "whk_01HZY31W2SZJ8MJ2FQTR3M1K9D",
  "url": "https://example.com/handinger-webhook"
}
Returns Examples
{
  "token": "whk_01HZY31W2SZJ8MJ2FQTR3M1K9D",
  "url": "https://example.com/handinger-webhook"
}