replay

Replay a captured webhook event to another destination.

Synopsis

wsignal replay <id> --to http://localhost:3000/test [--config ./wsignal.config.ts]

What It Does

wsignal replay loads a saved event and sends a new HTTP request to the destination URL you provide.

The replay request preserves:

• The original method
• The original body for methods that allow a body
• Most original headers

The replay request intentionally removes:

• host
• content-length

Those headers are stripped so the new request can be generated correctly for its new destination.

Required Arguments

<id>

The saved event ID to replay.

--to <url>

Destination URL for the replay request.

replay throws an error if --to is missing.

Optional Arguments

--config <path>

Use a specific config file when locating stored records.

Examples

Replay one event to a local route:

wsignal replay evt_20260329_xxxxxx --to http://localhost:3000/test

Replay using records from a custom config location:

wsignal replay evt_20260329_xxxxxx \
  --config ./config/webhooks.ts \
  --to http://localhost:3000/api/github-webhook

Related Behavior

replay is a manual operation. It is separate from endpoint forwarding configured in wsignal.config.ts.