Start a source replay

cURL

# Use a subscription id from POST or GET /v1/subscriptions; the placeholder answers 404.
curl --fail-with-body -sS -X POST 'https://webhooks-testnet.lumeus.dev/v1/subscriptions/00000000-0000-4000-8000-000000000000/source-replays' \
  -H "Authorization: Bearer $LUMEUS_WEBHOOK_KEY" \
  -H 'If-Match: "1"' \
  -H 'Idempotency-Key: retry-0001-2026-10-22' \
  -H 'Content-Type: application/json' \
  -d '{"generation":"testnet-2025-12-18-v2","first_ledger":5331500,"last_ledger":5331520,"max_deliveries":10,"quote_sha256":"dddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddd"}'

// Node 18+ (ES module)
// Use a subscription id from POST or GET /v1/subscriptions; the placeholder answers 404.
const res = await fetch('https://webhooks-testnet.lumeus.dev/v1/subscriptions/00000000-0000-4000-8000-000000000000/source-replays', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.LUMEUS_WEBHOOK_KEY}`,
    'If-Match': '"1"',
    'Idempotency-Key': 'retry-0001-2026-10-22',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "generation": "testnet-2025-12-18-v2",
    "first_ledger": 5331500,
    "last_ledger": 5331520,
    "max_deliveries": 10,
    "quote_sha256": "dddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddd"
  }),
});
console.log(res.status, JSON.stringify(await res.json(), null, 2));

# Use a subscription id from POST or GET /v1/subscriptions; the placeholder answers 404.
import json
import os

import requests

res = requests.post(
    "https://webhooks-testnet.lumeus.dev/v1/subscriptions/00000000-0000-4000-8000-000000000000/source-replays",
    headers={"Authorization": f"Bearer {os.environ['LUMEUS_WEBHOOK_KEY']}", "If-Match": "\"1\"", "Idempotency-Key": "retry-0001-2026-10-22"},
    json={
        "generation": "testnet-2025-12-18-v2",
        "first_ledger": 5331500,
        "last_ledger": 5331520,
        "max_deliveries": 10,
        "quote_sha256": "dddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddd"
    },
    timeout=30,
)
print(res.status_code, json.dumps(res.json(), indent=2))

{
  "kind": "source",
  "source_quote": {
    "protocol": "lumeus-source-replay-quote-v1",
    "subscription_id": "00000000-0000-4000-8000-000000000000",
    "subscription_version": 2,
    "network": "testnet",
    "request": {
      "generation": "testnet-2025-12-18-v2",
      "first_ledger": 5331500,
      "last_ledger": 5331520,
      "max_deliveries": 10
    },
    "source_policy_version": "prepaid-2026-10",
    "delivery_policy_version": "prepaid-2026-10",
    "target_sha256": "bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb",
    "maximum_credits": 12,
    "source_success_credits": 2,
    "source_bounds": {
      "response_bytes": 1048576,
      "timeout_ms": 10000,
      "max_events": 128,
      "max_payload_bytes": 65536
    },
    "source_max_attempts": 3,
    "resources": {
      "bytes": 4096,
      "attempts": 8,
      "work_ms": 0,
      "concurrency": 1,
      "retained_bytes": 0
    },
    "quote_sha256": "dddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddd"
  },
  "source_phase": "preparing",
  "id": "00000000-0000-4000-8000-000000000001",
  "subscription_id": "00000000-0000-4000-8000-000000000000",
  "generation": "testnet-2025-12-18-v2",
  "state": "preparing",
  "quote": {
    "subscription_id": "00000000-0000-4000-8000-000000000000",
    "subscription_version": 2,
    "generation": "testnet-2025-12-18-v2",
    "delivery_ids": [],
    "payload_sha256": [],
    "policy_version": "prepaid-2026-10",
    "target_sha256": "bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb",
    "maximum_credits": 12,
    "resources": {
      "bytes": 4096,
      "attempts": 8,
      "work_ms": 0,
      "concurrency": 1,
      "retained_bytes": 0
    },
    "quote_sha256": "dddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddd"
  },
  "pending": 0,
  "delivered": 0,
  "dead": 0,
  "in_flight": 0,
  "created_at": "2026-10-22T09:15:04Z"
}

POST

subscriptions

{id}

source-replays

cURL

# Use a subscription id from POST or GET /v1/subscriptions; the placeholder answers 404.
curl --fail-with-body -sS -X POST 'https://webhooks-testnet.lumeus.dev/v1/subscriptions/00000000-0000-4000-8000-000000000000/source-replays' \
  -H "Authorization: Bearer $LUMEUS_WEBHOOK_KEY" \
  -H 'If-Match: "1"' \
  -H 'Idempotency-Key: retry-0001-2026-10-22' \
  -H 'Content-Type: application/json' \
  -d '{"generation":"testnet-2025-12-18-v2","first_ledger":5331500,"last_ledger":5331520,"max_deliveries":10,"quote_sha256":"dddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddd"}'

// Node 18+ (ES module)
// Use a subscription id from POST or GET /v1/subscriptions; the placeholder answers 404.
const res = await fetch('https://webhooks-testnet.lumeus.dev/v1/subscriptions/00000000-0000-4000-8000-000000000000/source-replays', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.LUMEUS_WEBHOOK_KEY}`,
    'If-Match': '"1"',
    'Idempotency-Key': 'retry-0001-2026-10-22',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "generation": "testnet-2025-12-18-v2",
    "first_ledger": 5331500,
    "last_ledger": 5331520,
    "max_deliveries": 10,
    "quote_sha256": "dddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddd"
  }),
});
console.log(res.status, JSON.stringify(await res.json(), null, 2));

# Use a subscription id from POST or GET /v1/subscriptions; the placeholder answers 404.
import json
import os

import requests

res = requests.post(
    "https://webhooks-testnet.lumeus.dev/v1/subscriptions/00000000-0000-4000-8000-000000000000/source-replays",
    headers={"Authorization": f"Bearer {os.environ['LUMEUS_WEBHOOK_KEY']}", "If-Match": "\"1\"", "Idempotency-Key": "retry-0001-2026-10-22"},
    json={
        "generation": "testnet-2025-12-18-v2",
        "first_ledger": 5331500,
        "last_ledger": 5331520,
        "max_deliveries": 10,
        "quote_sha256": "dddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddd"
    },
    timeout=30,
)
print(res.status_code, json.dumps(res.json(), indent=2))

{
  "kind": "source",
  "source_quote": {
    "protocol": "lumeus-source-replay-quote-v1",
    "subscription_id": "00000000-0000-4000-8000-000000000000",
    "subscription_version": 2,
    "network": "testnet",
    "request": {
      "generation": "testnet-2025-12-18-v2",
      "first_ledger": 5331500,
      "last_ledger": 5331520,
      "max_deliveries": 10
    },
    "source_policy_version": "prepaid-2026-10",
    "delivery_policy_version": "prepaid-2026-10",
    "target_sha256": "bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb",
    "maximum_credits": 12,
    "source_success_credits": 2,
    "source_bounds": {
      "response_bytes": 1048576,
      "timeout_ms": 10000,
      "max_events": 128,
      "max_payload_bytes": 65536
    },
    "source_max_attempts": 3,
    "resources": {
      "bytes": 4096,
      "attempts": 8,
      "work_ms": 0,
      "concurrency": 1,
      "retained_bytes": 0
    },
    "quote_sha256": "dddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddd"
  },
  "source_phase": "preparing",
  "id": "00000000-0000-4000-8000-000000000001",
  "subscription_id": "00000000-0000-4000-8000-000000000000",
  "generation": "testnet-2025-12-18-v2",
  "state": "preparing",
  "quote": {
    "subscription_id": "00000000-0000-4000-8000-000000000000",
    "subscription_version": 2,
    "generation": "testnet-2025-12-18-v2",
    "delivery_ids": [],
    "payload_sha256": [],
    "policy_version": "prepaid-2026-10",
    "target_sha256": "bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb",
    "maximum_credits": 12,
    "resources": {
      "bytes": 4096,
      "attempts": 8,
      "work_ms": 0,
      "concurrency": 1,
      "retained_bytes": 0
    },
    "quote_sha256": "dddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddd"
  },
  "pending": 0,
  "delivered": 0,
  "dead": 0,
  "in_flight": 0,
  "created_at": "2026-10-22T09:15:04Z"
}

Authorizations

Authorization

string

header

required

Send Authorization: Bearer whk_…, a webhook key from the dashboard. Webhook keys belong to one network, so pick the server that matches the key. lum_ API keys are not accepted here (401).

Headers

If-Match

string

required

The ETag from GET /v1/subscriptions/{id}, for example "1" (the weak form W/"1" that some proxies produce is accepted too). A stale version returns 412; a missing header returns 428.

Pattern: ^(W/)?"[1-9][0-9]*"$

Example:

"\"1\""

Idempotency-Key

string

required

Required. Choose one key per change and resend it unchanged on a retry: the same key with the same request returns the first result instead of applying the change again, and the same key with a different request returns 409.

Required string length: 1 - 128

Example:

"retry-0001-2026-10-22"

Path Parameters

string<uuid>

required

Endpoint (subscription) ID from POST /v1/subscriptions or GET /v1/subscriptions. The example ID is a placeholder and answers 404: use your own.

Example:

"00000000-0000-4000-8000-000000000000"

Body

application/json

generation

string

required

first_ledger

integer

required

Required range: x >= 3

last_ledger

integer

required

Inclusive end; must satisfy the selected bounded source policy.

max_deliveries

integer

required

Required range: x >= 1

quote_sha256

string

required

quote_sha256 from the quote response.

Pattern: ^[0-9a-fA-F]{64}$

Response

The same Idempotency-Key was sent before: the existing job.

kind

enum<string>

required

retained: a redelivery of retained payloads; source: a source replay.

Available options:

retained,

source

string<uuid>

required

subscription_id

string<uuid>

required

generation

string

required

state

string

required

pending

integer

required

delivered

integer

required

dead

integer

required

in_flight

integer

required

created_at

string<date-time>

required

source_quote

object

Show child attributes

source_phase

string

source_attempts

integer

failure_code

string

quote

object

Show child attributes

Activity API

Assets API

Webhooks

RPC

Account

Start a source replay

Authorizations

Headers

Path Parameters

Body

Response