Skip to main content
DELETE
/
v1
/
sessions
/
{id}
Stop Session
curl --request DELETE \
  --url https://api.example.com/v1/sessions/{id}
Stop an active browser session. Returns the billing summary with total duration and credits charged.

​
Request

​
Headers

HeaderRequiredDescription
x-api-keyYesYour API key

​
Path Parameters

ParameterTypeDescription
idstringSession ID

​
Response

​
200 OK

{
  "success": true,
  "data": {
    "sessionId": "ses_a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "status": "stopped",
    "durationMs": 45000,
    "creditsCharged": 1
  }
}

​
Fields

FieldDescription
sessionIdSession that was stopped
statusAlways "stopped"
durationMsHow long the session was active in milliseconds
creditsChargedTotal credits charged for this session

​
Errors

CodeStatusDescription
session_not_found404Session does not exist or belongs to another workspace
session_expired410Session already stopped or expired

​
Webhook

A session.stopped webhook event is fired with the billing summary.