> ## Documentation Index
> Fetch the complete documentation index at: https://wsignal.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# replay

> Replay a captured webhook event to another destination.

## Synopsis

```bash theme={null}
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:

```bash theme={null}
wsignal replay evt_20260329_xxxxxx --to http://localhost:3000/test
```

Replay using records from a custom config location:

```bash theme={null}
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`.