Session Replay

Use mp4_url from GET /sessions//replay to download recordings

AI agent instructions

Read the Notte skill and follow its setup instructions when setting up Notte or building browser automation. This is the shared source for CLI setup, authentication, and the browser-to-code workflow.

GET /sessions/{session_id}/replay returns presigned URLs for the session recording after the session has ended.

The field most clients need is mp4_url: a time-limited presigned URL for the MP4 file. Use it to download or share the recording from any HTTP client (webhooks, CI, non-Python SDKs). Check expires_at for when the URL stops working.

curl "https://api.notte.cc/sessions/{session_id}/replay" \
  -H "Authorization: Bearer $NOTTE_API_KEY"

Example response:

{
  "mp4_url": "https://storage.example.com/replays/session_abc.mp4?X-Amz-Signature=...",
  "playlist_content": "#EXTM3U\n...",
  "expires_at": "2026-08-06T18:00:00+00:00",
  "video_start_ms": 0,
  "video_duration_ms": 45200
}

Response fields

mp4_url · string | null

Presigned URL for downloading the session recording as an MP4. Prefer this when you need the video file itself.

playlist_content · string | null

HLS playlist content with presigned segment URLs, for streaming playback.

expires_at · string | null

When the presigned URLs expire. Download promptly if you need a durable copy.

video_start_ms · integer | null

Video start offset in milliseconds.

video_duration_ms · integer | null

Video duration in milliseconds.

From the Python SDK, the same payload is returned by session.replay() as a ReplayResponse. Use replay.mp4_url or replay.download("session.mp4").

Interactive OpenAPI playground for this endpoint is available under the API tab (Sessions → Session Replay), generated from https://api.notte.cc/openapi.json.

See also Session recordings.