Skip to content
Handinger
Get started
API Reference
Workers
Webhooks

List worker webhook executions

workers.webhooks.list_executions(strworker_id, WebhookListExecutionsParams**kwargs) -> WebhookExecutionList
GET/api/workers/{workerId}/webhook/executions

List recent webhook delivery attempts for a worker, newest first, paginated 50 per page. Only the worker creator can read execution history.

ParametersExpand Collapse
worker_id: str
page: Optional[int]

Page number (1-indexed). Defaults to 1.

minimum1
ReturnsExpand Collapse
class WebhookExecutionList: …
logs: List[WebhookExecution]
id: str
created_at: datetime
formatdate-time
duration_ms: int

Wall-clock time spent on the delivery attempt.

error_message: Optional[str]

Failure reason when requestStatus is error.

request_status: Literal["success", "error"]

success when the endpoint returned a 2xx response, error otherwise.

One of the following:
"success"
"error"
response_status: Optional[int]

HTTP status returned by the endpoint, when reachable.

task_id: Optional[str]

Task that triggered the delivery, when available.

task_title: Optional[str]

Title of the originating task, when available.

url: str

Endpoint Handinger attempted to deliver to.

worker_id: str
page: int

Current page number.

page_count: int

Total number of pages available.

total_count: int

Total number of executions recorded.

List worker webhook executions

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_execution_list = client.workers.webhooks.list_executions(
    worker_id="t_org_123_w_01HZY2ZJQ8G7K42W2D7WF6V4GM",
)
print(webhook_execution_list.logs)
{
  "logs": [
    {
      "id": "whe_01HZY31W2SZJ8MJ2FQTR3M1K9D",
      "createdAt": "2019-12-27T18:11:19.117Z",
      "durationMs": 0,
      "errorMessage": "errorMessage",
      "requestStatus": "success",
      "responseStatus": 0,
      "taskId": "taskId",
      "taskTitle": "taskTitle",
      "url": "url",
      "workerId": "workerId"
    }
  ],
  "page": 0,
  "pageCount": 0,
  "totalCount": 0
}
Returns Examples
{
  "logs": [
    {
      "id": "whe_01HZY31W2SZJ8MJ2FQTR3M1K9D",
      "createdAt": "2019-12-27T18:11:19.117Z",
      "durationMs": 0,
      "errorMessage": "errorMessage",
      "requestStatus": "success",
      "responseStatus": 0,
      "taskId": "taskId",
      "taskTitle": "taskTitle",
      "url": "url",
      "workerId": "workerId"
    }
  ],
  "page": 0,
  "pageCount": 0,
  "totalCount": 0
}