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//purge. Surfaces shared with a still-live sibling run are deferred by the same guards the cron uses.
POST
/
sessions
/
{session_id}
/
purge
Purge Session
const options = {method: 'POST', headers: {'X-Browser-Use-API-Key': '<api-key>'}};
fetch('https://api.browser-use.com/api/v4/sessions/{session_id}/purge', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));curl --request POST \
--url https://api.browser-use.com/api/v4/sessions/{session_id}/purge \
--header 'X-Browser-Use-API-Key: <api-key>'import requests
url = "https://api.browser-use.com/api/v4/sessions/{session_id}/purge"
headers = {"X-Browser-Use-API-Key": "<api-key>"}
response = requests.post(url, headers=headers)
print(response.text){
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>"
}
]
}Was this page helpful?
⌘I
Purge Session
const options = {method: 'POST', headers: {'X-Browser-Use-API-Key': '<api-key>'}};
fetch('https://api.browser-use.com/api/v4/sessions/{session_id}/purge', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));curl --request POST \
--url https://api.browser-use.com/api/v4/sessions/{session_id}/purge \
--header 'X-Browser-Use-API-Key: <api-key>'import requests
url = "https://api.browser-use.com/api/v4/sessions/{session_id}/purge"
headers = {"X-Browser-Use-API-Key": "<api-key>"}
response = requests.post(url, headers=headers)
print(response.text){
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>"
}
]
}