sangtao.ai
API key

Webhooks

List deliveries

What was sent to an endpoint, and how each delivery went.

GEThttps://api.sangtao.ai/v2/webhooks/{id}/deliveries

Authorization

  • X-Api-Keystring · headerrequired

    Your API key, from the API keys page of your account.

Path parameters

  • idstringrequired

    The ID in the path.

The last 30 days of deliveries to this endpoint, newest first.

Query parameters

  • statusstring

    Only this status

    Available options:pendingsucceededfailedcanceled

  • typestring

    Only this event type

    Available options:image.completedimage.failedvideo.completedvideo.failedpost.publishedpost.failedsocial_account.needs_attentionwebhook.test

  • sincestring

    Created at or after (ISO 8601)

  • untilstring

    Created at or before (ISO 8601)

  • pagenumber

    From 1

  • pageSizenumber

    20 by default, at most 100. The total is in X-Total-Count

Response

  • idstringrequired

    The delivery, dlv_…

  • eventIdstringrequired

    The event, evt_… — the same on a retry

  • eventTypestringrequired

    e.g. image.completed

  • statusstringrequired

    canceled: the endpoint was deleted or turned off before it went

    Available options:pendingsucceededfailedcanceled

  • attemptCountnumberrequired

    Attempts so far

  • lastHttpStatusnumber | null

    What your URL answered last

  • lastErrorstring | null

    Why the last attempt failed

  • nextAttemptAtstring | null

    The next retry. Only while pending

  • createdAtstringrequired

    When the delivery was queued

  • completedAtstring | null

    When it ended: succeeded, failed or canceled

Errors

StatuserrorCodeWhen
404WEBHOOK_NOT_FOUNDNo endpoint of yours with this id
GET/webhooks/{id}/deliveries
curl "https://api.sangtao.ai/v2/webhooks/whk_4nP8rT2xK/deliveries?status=failed&page=1&pageSize=20" \
  -H "X-Api-Key: YOUR_API_KEY"
{
  "success": true,
  "data": [
    {
      "id": "dlv_5Vt1kRm9P",
      "eventId": "evt_8Kq2mXa7T",
      "eventType": "image.completed",
      "status": "failed",
      "attemptCount": 8,
      "lastHttpStatus": 500,
      "lastError": "HTTP 500",
      "nextAttemptAt": null,
      "createdAt": "2026-11-10T09:43:31Z",
      "completedAt": "2026-11-12T00:00:00Z"
    }
  ]
}