Skip to main content
POST
/
browser
/
sessions
/
{id}
/
recording
/
stop
Stop Recording
curl --request POST \
  --url https://api.example.com/browser/sessions/{id}/recording/stop
{
  "recordingId": "<string>",
  "status": "<string>"
}

​
Overview

Stops the active recording and finalizes the MP4 container. After this returns, the file is downloadable via GET /browser/sessions/{id}/recording.

​
Path Parameters

​
id
string
required
Browser session ID (UUID).

​
Example Request

curl -X POST "https://api.scrapengine.io/api/v1/browser/sessions/baa3f390-fa6e-4a24-b84a-a575a5f3a9c7/recording/stop" \
  -H "Authorization: Bearer $SCRAPENGINE_API_KEY"

​
Response

​
Success Response (200)

​
recordingId
string
Identifier of the recording that was stopped.
​
status
string
Final state — stopped.
Example Response: 
{
  "recordingId": "rec-01HX3...",
  "status": "stopped"
}

​
Error Responses

StatusDescription
401Unauthorized — invalid or missing API key.
404Session not found, or no recording is in progress.