v1

latestOpenAPI 3.1.02026-07-22154213404.8 KB

Webhooks

Register a webhook subscription

Creates a webhook subscription with a delivery URL and an optional list of event types to subscribe to (defaults to all when omitted). The response includes the generated signing secret, which is returned only once at creation time and cannot be retrieved later.

post/webhooks

Request body

urlstring uri required

eventTypesstring[]

descriptionstring

Example request

{
  "url": "https://example.com/webhooks/droidrun",
  "eventTypes": [
    "task.run.completed",
    "task.run.failed"
  ]
}

Response

Webhook created (secret shown once)