Sessions
Purge Session
Purge V4 session data; return 202 while active work or uploads defer deletion.
Redacts DB records and deletes S3 objects (bcode state, workspace files, recordings, downloads, staging uploads) for every run in the session. Same cleanup the ZDR cron performs, but on-demand; outstanding upload grants defer physical deletion. V4 analog of the V2 POST /sessions/{id}/purge. Surfaces shared with a still-live sibling run are deferred by the same guards the cron uses.
post/sessions/{session_id}/purge
Request
- Base URL: https://api.browser-use.com/api/v4
- URL: https://api.browser-use.com/api/v4/sessions/{session_id}/purge
- Auth: API key in header X-Browser-Use-API-Key
Path parameters
session_idstring uuid required
Response
Purge pending active work or outstanding uploads.
Changes
No recorded changes to this operation across all 1 revision of this API.