Live view and session replays

You can watch a browser session while it runs, and you can record sessions to play them back later. Both are free. This guide shows how to use them and how long Wayfern keeps a replay.

Watch a session live

Open the link page in the dashboard, then Live sessions, then Watch.

• Live view is read-only.
• It shows up to 5 frames a second, scaled to fit 1280 pixels.
• Wayfern stores nothing from a live view.
• Any project member can watch. Up to 10 people can watch one session.
• Wayfern captures over its own connection to the browser and runs no script in your pages. Your automation sees no difference.

To list the running sessions of a link, call the sessions route. Link routes take a dashboard session token, not a wf_ API token.

curl https://api.wayfern.com/api/projects/$PROJECT_ID/links/$LINK_ID/sessions \
  -H "Authorization: Bearer $DASHBOARD_JWT"

{
  "sessions": [
    {
      "sessionId": "0c2c3a1e-…",
      "startedAt": "2026-10-11T14:02:11.000Z",
      "recording": true,
      "activePage": { "url": "https://example.com/pricing", "title": "Pricing" },
      "pages": 2,
      "viewport": { "width": 1366, "height": 768 }
    }
  ]
}

Record sessions

Recording is off by default. A project owner or admin turns on Record sessions in the link settings, or sends "recordSessions": true in a link update. Recording needs a plan or credits on the project owner’s account.

• Every new session of that link is recorded.
• Add record=0 to a connection URL to skip one session.
• record=1 cannot turn recording on for a link that has it off.
• The connected message tells your client if the session records, in its recording field.

Wayfern takes a frame only when the page changes, at up to 2 frames a second. A recording stops after 60 minutes, 100 MB or 7,200 frames, whichever comes first. The replay marks the point where it stopped.

Read replays over the API

Route	Who
GET /api/projects/{projectId}/links/{linkId}/replays	Project members
GET /api/projects/{projectId}/links/{linkId}/replays/{replayId}	Project members
GET /api/projects/{projectId}/links/{linkId}/replays/{replayId}/segments/{n}	Project members
DELETE /api/projects/{projectId}/links/{linkId}/replays/{replayId}	Owners and admins

• The list is newest first. It takes page and pageSize (1 to 100, default 20). It also returns retentionDays and recordingAvailable.
• One replay comes with its manifest. The manifest lists the frames with their times, and every navigation with its URL and title. The dashboard player shows the navigations as timeline markers.
• A segment returns signed frame URLs. They stay valid for 15 minutes.
• You cannot delete a replay while its session still records. The API answers 409.

curl "https://api.wayfern.com/api/projects/$PROJECT_ID/links/$LINK_ID/replays?page=1&pageSize=20" \
  -H "Authorization: Bearer $DASHBOARD_JWT"

Retention

The plan of the project owner sets how long a new replay is kept:

Plan	Replays kept
Developer, and credit packs without a plan	1 day
Business	7 days
Scale	30 days
Enterprise	90 days

At the end of its retention, Wayfern deletes the frames and the index. When you delete a link or a project, its replays are deleted within an hour.

Privacy

A replay holds screenshots of the pages, with their URLs and titles. Only project members can see it. If a session shows data that must not be kept, such as a logged-in account page, connect with record=0.

Limits are in Live view and replays and the replay reference.