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.