Enable recording at session creation with browserSettings.recordSession:true. Recording must be supported by the configured transport; otherwise the service returns an explicit refusal.
curl "https://api.tooluse.net/v1/browsers/sessions/$SESSION_ID/replays" \
-H "Authorization: Bearer $TOOLUSE_API_KEY"
The native endpoint lists retained pages. Read GET /v1/browsers/sessions/{id}/replays/{pageId}?page=1&size=20 for paginated base64 JPEG frames. This native route is not an HLS playlist. Replay frames are retained for 24 hours, subject to the deployment’s recorder availability and bounded storage.
To obtain an MP4 after a recorded session ends, use recording downloads.