Get Webhook Trigger Event

Retrieve one delivery event in full, including the payload as received and the run it started. `request_data.request_headers` reports every header the request arrived with, the signature header among them, so treat this response as sensitive. `source_ip` records the immediate peer — behind a proxy that is the ingress address, and the caller's own address appears in the forwarded headers.

Authentication

AuthorizationBearer

API key or access token, sent as Authorization: Bearer <token>. The simplest option: create an API key in your dashboard under Settings, then paste it here.

OR
AuthorizationBearer

API key or access token, sent as Authorization: Bearer <token>. The simplest option: create an API key in your dashboard under Settings, then paste it here.

Path parameters

org_idstringRequiredformat: "uuid"
The organization ID
project_idstringRequiredformat: "uuid"
The project ID
trigger_idstringRequiredformat: "uuid"
event_idstringRequiredformat: "uuid"

Response

Webhook trigger delivery event details retrieved successfully
idstringformat: "uuid"
Unique identifier for the event.
webhook_trigger_idstringformat: "uuid"
The trigger this event belongs to.
request_idstring
Request ID for tracing.
http_methodstring
HTTP method of the request.
statusstring

Event status (received, processing, completed, failed, duplicate, skipped).

received_atstring
When the webhook was received.
request_dataobject
Captured and transformed request data.
idempotency_keystring or nullOptional
Idempotency key if extracted.
source_ipstring or nullOptional
Source IP address of the request.
error_messagestring or nullOptional
Error message if failed.
error_codestring or nullOptional
Error code if failed.
task_run_idstring or nullOptionalformat: "uuid"
Associated TaskRun ID if successful.
task_agent_run_idstring or nullOptionalformat: "uuid"
Associated TaskAgentRun ID if successful.
completed_atstring or nullOptional
When processing completed.
response_status_codeinteger or nullOptional
HTTP response status code.
response_time_msinteger or nullOptional
Response time in milliseconds.
task_agent_idstring or nullOptionalformat: "uuid"

The TaskAgent ID for agent-targeted triggers.

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
404
Not Found Error
422
Unprocessable Entity Error
500
Internal Server Error