Redeliver

Replay a finished delivery: reset it to PENDING and re-fire the signed POST.

404 if the delivery isn’t visible to the caller; 409 if a delivery for the request is still in flight (a replay must not stack on it). The delivery is re-validated (SSRF) and re-signed at send time, and the receiver dedupes on X-Hedra-Webhook-Id, so a replay is safe.

The webhook id is stable across the original and every replay, because it identifies the event. Every attempt of a replayed cycle therefore also carries X-Hedra-Webhook-Redelivery: true — without it a receiver doing exactly what our guidance says (dedupe on the id) would silently discard the replay, which is the one case where the duplicate is the point.

POST

webhooks

deliveries

{job_id}

redeliver

Redeliver

curl --request POST \
  --url https://api.hedra.com/v3/webhooks/deliveries/{job_id}/redeliver \
  --header 'Authorization: <api-key>'

import requests

url = "https://api.hedra.com/v3/webhooks/deliveries/{job_id}/redeliver"

headers = {"Authorization": "<api-key>"}

response = requests.post(url, headers=headers)

print(response.text)

const options = {method: 'POST', headers: {Authorization: '<api-key>'}};

fetch('https://api.hedra.com/v3/webhooks/deliveries/{job_id}/redeliver', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.hedra.com/v3/webhooks/deliveries/{job_id}/redeliver",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_HTTPHEADER => [
    "Authorization: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.hedra.com/v3/webhooks/deliveries/{job_id}/redeliver"

	req, _ := http.NewRequest("POST", url, nil)

	req.Header.Add("Authorization", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.hedra.com/v3/webhooks/deliveries/{job_id}/redeliver")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "job_id": "<string>",
  "job_accessible": true,
  "model": "<string>",
  "attempts": 123,
  "webhook_url": "<string>",
  "created_at": "2023-11-07T05:31:56Z",
  "redelivery_count": 0,
  "redeliveries": [],
  "last_response_status": 123,
  "last_error": {
    "message": "<string>",
    "retryable": false,
    "retry_after": 123,
    "param": "<string>",
    "details": [
      {
        "field": "<string>",
        "message": "<string>",
        "reason": "<string>",
        "allowed": [
          "<string>"
        ]
      }
    ],
    "replaced_by": "<string>"
  },
  "last_attempt_at": "2023-11-07T05:31:56Z"
}

Authorizations

Authorization

string

header

required

Primary scheme: Authorization: Key <key_id>:<secret>.

Path Parameters

job_id

string

required

Response

Successful Response

job_id

string

required

job_accessible

boolean

required

model

string

required

status

enum<string>

required

Where a delivery stands: queued, in flight, or its terminal outcome.

Available options:

PENDING,

DELIVERING,

DELIVERED,

FAILED

source

enum<string>

required

Which URL resolution created this delivery.

Available options:

per_job,

default

attempts

integer

required

webhook_url

string

required

created_at

string<date-time>

required

event_type

enum<string> | null

The terminal events an outbound webhook announces.

One delivery carries exactly one of these, chosen from the job's final status when the delivery fires.

Available options:

job.completed,

job.failed

redelivery_count

integer

default:0

redeliveries

WebhookRedelivery · object[]

Show child attributes

last_response_status

integer | null

last_error

ErrorEnvelope · object | null

Why the most recent delivery attempt failed, in the same error envelope GET /jobs/{job_id} returns for a failed job: a stable code from the shared error vocabulary, a fixed operator-facing message, and retryable. Null while no attempt has failed. Destination URLs, addresses, headers, credentials, response bodies, and internal exception text are never included — those stay in Hedra's own logs. retryable describes the condition, not what Hedra did: every non-2xx response is retried on the published ladder, so it answers whether replaying this delivery is likely to help. Deliveries that failed before this field became structured report UNKNOWN.

Show child attributes

last_attempt_at

string<date-time> | null

Webhook: jobcompletedPOSTed to the job's registered webhook URL when the job completes. Delivery is at-least-once: dedupe on `X-Hedra-Webhook-Id` and verify `X-Hedra-Webhook-Signature` before acting.

⌘I

Redeliver

curl --request POST \
  --url https://api.hedra.com/v3/webhooks/deliveries/{job_id}/redeliver \
  --header 'Authorization: <api-key>'

import requests

url = "https://api.hedra.com/v3/webhooks/deliveries/{job_id}/redeliver"

headers = {"Authorization": "<api-key>"}

response = requests.post(url, headers=headers)

print(response.text)

const options = {method: 'POST', headers: {Authorization: '<api-key>'}};

fetch('https://api.hedra.com/v3/webhooks/deliveries/{job_id}/redeliver', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.hedra.com/v3/webhooks/deliveries/{job_id}/redeliver",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_HTTPHEADER => [
    "Authorization: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.hedra.com/v3/webhooks/deliveries/{job_id}/redeliver"

	req, _ := http.NewRequest("POST", url, nil)

	req.Header.Add("Authorization", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.hedra.com/v3/webhooks/deliveries/{job_id}/redeliver")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "job_id": "<string>",
  "job_accessible": true,
  "model": "<string>",
  "attempts": 123,
  "webhook_url": "<string>",
  "created_at": "2023-11-07T05:31:56Z",
  "redelivery_count": 0,
  "redeliveries": [],
  "last_response_status": 123,
  "last_error": {
    "message": "<string>",
    "retryable": false,
    "retry_after": 123,
    "param": "<string>",
    "details": [
      {
        "field": "<string>",
        "message": "<string>",
        "reason": "<string>",
        "allowed": [
          "<string>"
        ]
      }
    ],
    "replaced_by": "<string>"
  },
  "last_attempt_at": "2023-11-07T05:31:56Z"
}