Fetch delivery

curl --request GET \
  --url https://api.gotohuman.com/webhooks/deliveries/whd_agent_abc123 \
  --header 'x-api-key: YOUR_API_KEY'

{
  "accountId": "abFMvLv4HafQymWxKDAov",
  "deliveryId": "whd_agent_abc123",
  "status": "succeeded",
  "ok": true,
  "statusCode": 200,
  "statusText": "OK",
  "event": "review.completed",
  "target": "agent",
  "urlSource": "request",
  "webhook": "https://example.com/hooks/gotohuman",
  "reviewId": "123456abcdef",
  "formId": "123456abcdef",
  "formName": "Review AI Draft",
  "agentId": "agent123456abcdef",
  "sessionId": "session789abcdef",
  "attemptCount": 1,
  "maxAttempts": 7,
  "attempts": [
    {
      "attemptId": "attempt-1",
      "ok": true,
      "statusCode": 200,
      "scheduledBy": "inline",
      "at": "2027-10-05T14:48:02.000Z"
    }
  ],
  "triggeredAt": "2027-10-05T14:48:00.000Z",
  "updatedAt": "2027-10-05T14:48:02.000Z"
}

{
  "accountId": "abFMvLv4HafQymWxKDAov",
  "deliveryId": "whd_agent_abc123",
  "status": "retrying",
  "ok": false,
  "statusCode": 500,
  "statusText": "Internal Server Error",
  "event": "review.completed",
  "target": "agent",
  "urlSource": "agent",
  "webhook": "https://example.com/hooks/gotohuman",
  "reviewId": "123456abcdef",
  "formId": "123456abcdef",
  "formName": "Review AI Draft",
  "agentId": "agent123456abcdef",
  "sessionId": "session789abcdef",
  "attemptCount": 2,
  "maxAttempts": 7,
  "attempts": [
    {
      "attemptId": "attempt-1",
      "ok": false,
      "statusCode": 500,
      "scheduledBy": "inline",
      "at": "2027-10-05T14:48:02.000Z"
    },
    {
      "attemptId": "attempt-2",
      "ok": false,
      "statusCode": 500,
      "scheduledBy": "cloud-task",
      "at": "2027-10-05T14:49:05.000Z"
    }
  ],
  "nextRetryAt": "2027-10-05T14:54:05.000Z",
  "triggeredAt": "2027-10-05T14:48:00.000Z",
  "updatedAt": "2027-10-05T14:49:05.000Z"
}

GET

webhooks

deliveries

{deliveryId}

curl --request GET \
  --url https://api.gotohuman.com/webhooks/deliveries/whd_agent_abc123 \
  --header 'x-api-key: YOUR_API_KEY'

{
  "accountId": "abFMvLv4HafQymWxKDAov",
  "deliveryId": "whd_agent_abc123",
  "status": "succeeded",
  "ok": true,
  "statusCode": 200,
  "statusText": "OK",
  "event": "review.completed",
  "target": "agent",
  "urlSource": "request",
  "webhook": "https://example.com/hooks/gotohuman",
  "reviewId": "123456abcdef",
  "formId": "123456abcdef",
  "formName": "Review AI Draft",
  "agentId": "agent123456abcdef",
  "sessionId": "session789abcdef",
  "attemptCount": 1,
  "maxAttempts": 7,
  "attempts": [
    {
      "attemptId": "attempt-1",
      "ok": true,
      "statusCode": 200,
      "scheduledBy": "inline",
      "at": "2027-10-05T14:48:02.000Z"
    }
  ],
  "triggeredAt": "2027-10-05T14:48:00.000Z",
  "updatedAt": "2027-10-05T14:48:02.000Z"
}

{
  "accountId": "abFMvLv4HafQymWxKDAov",
  "deliveryId": "whd_agent_abc123",
  "status": "retrying",
  "ok": false,
  "statusCode": 500,
  "statusText": "Internal Server Error",
  "event": "review.completed",
  "target": "agent",
  "urlSource": "agent",
  "webhook": "https://example.com/hooks/gotohuman",
  "reviewId": "123456abcdef",
  "formId": "123456abcdef",
  "formName": "Review AI Draft",
  "agentId": "agent123456abcdef",
  "sessionId": "session789abcdef",
  "attemptCount": 2,
  "maxAttempts": 7,
  "attempts": [
    {
      "attemptId": "attempt-1",
      "ok": false,
      "statusCode": 500,
      "scheduledBy": "inline",
      "at": "2027-10-05T14:48:02.000Z"
    },
    {
      "attemptId": "attempt-2",
      "ok": false,
      "statusCode": 500,
      "scheduledBy": "cloud-task",
      "at": "2027-10-05T14:49:05.000Z"
    }
  ],
  "nextRetryAt": "2027-10-05T14:54:05.000Z",
  "triggeredAt": "2027-10-05T14:48:00.000Z",
  "updatedAt": "2027-10-05T14:49:05.000Z"
}

See Introduction for the base URL and authentication. Fetch the status of a webhook delivery, including each attempt. Delivery IDs are returned on a completed review as webhookDeliveryId. See Fetch review.

Path Parameters

string

required

The ID of the webhook delivery.

curl --request GET \
  --url https://api.gotohuman.com/webhooks/deliveries/whd_agent_abc123 \
  --header 'x-api-key: YOUR_API_KEY'

{
  "accountId": "abFMvLv4HafQymWxKDAov",
  "deliveryId": "whd_agent_abc123",
  "status": "succeeded",
  "ok": true,
  "statusCode": 200,
  "statusText": "OK",
  "event": "review.completed",
  "target": "agent",
  "urlSource": "request",
  "webhook": "https://example.com/hooks/gotohuman",
  "reviewId": "123456abcdef",
  "formId": "123456abcdef",
  "formName": "Review AI Draft",
  "agentId": "agent123456abcdef",
  "sessionId": "session789abcdef",
  "attemptCount": 1,
  "maxAttempts": 7,
  "attempts": [
    {
      "attemptId": "attempt-1",
      "ok": true,
      "statusCode": 200,
      "scheduledBy": "inline",
      "at": "2027-10-05T14:48:02.000Z"
    }
  ],
  "triggeredAt": "2027-10-05T14:48:00.000Z",
  "updatedAt": "2027-10-05T14:48:02.000Z"
}

{
  "accountId": "abFMvLv4HafQymWxKDAov",
  "deliveryId": "whd_agent_abc123",
  "status": "retrying",
  "ok": false,
  "statusCode": 500,
  "statusText": "Internal Server Error",
  "event": "review.completed",
  "target": "agent",
  "urlSource": "agent",
  "webhook": "https://example.com/hooks/gotohuman",
  "reviewId": "123456abcdef",
  "formId": "123456abcdef",
  "formName": "Review AI Draft",
  "agentId": "agent123456abcdef",
  "sessionId": "session789abcdef",
  "attemptCount": 2,
  "maxAttempts": 7,
  "attempts": [
    {
      "attemptId": "attempt-1",
      "ok": false,
      "statusCode": 500,
      "scheduledBy": "inline",
      "at": "2027-10-05T14:48:02.000Z"
    },
    {
      "attemptId": "attempt-2",
      "ok": false,
      "statusCode": 500,
      "scheduledBy": "cloud-task",
      "at": "2027-10-05T14:49:05.000Z"
    }
  ],
  "nextRetryAt": "2027-10-05T14:54:05.000Z",
  "triggeredAt": "2027-10-05T14:48:00.000Z",
  "updatedAt": "2027-10-05T14:49:05.000Z"
}

Response

string

ID of the account that owns the delivery.

string

ID of the webhook delivery.

string

pending, delivering, succeeded, retrying, or dead.

boolean

true when the latest attempt returned a successful HTTP response.

number

HTTP status code from the latest attempt.

string

HTTP status text from the latest attempt.

string

Webhook event. review.completed or trigger.submitted.

string

Where the webhook was sent. agent, tool, or audit.

string

Which webhook URL was used. request, form, or agent.

string

URL the delivery was sent to.

string

ID of the review that triggered the delivery.

string

ID of the review type.

string

Name of the review type.

string

ID of the agent.

string

Session or workflow run.

number

Number of automatic attempts so far.

number

Maximum automatic attempts. Failed deliveries retry up to 7 times. See Retries.

object[]

One entry per attempt, in order.

Show properties

string

ID of the attempt, such as attempt-1.

boolean

true when this attempt returned a successful HTTP response.

number

HTTP status code from this attempt.

string

inline for the first attempt, cloud-task for an automatic retry, or manual for a retry from the review history.

string

ISO 8601 timestamp of the attempt.

string

ISO 8601 timestamp of the next automatic retry. Present while status is retrying.

boolean

true when auto-retries were stopped. The delivery status is then dead.

string

ISO 8601 timestamp when the delivery was created.

string

ISO 8601 timestamp of the latest update.

GET STARTED

Human reviews

Notifications

Integrations

API Reference

Examples

More

Path Parameters

Response

​Path Parameters

​Response

Path Parameters

Response