Skip to main content
POST
/
cleanup
curl -X POST http://localhost:3000/cleanup \
  -H "Authorization: Bearer $ISOL8_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "images": true }'

{
  "ok": true,
  "sessions": { "removed": 2, "failed": 0, "errors": [] },
  "containers": { "removed": 4, "failed": 0, "errors": [] },
  "images": { "removed": 5, "failed": 0, "errors": [] }
}
Runs server-side cleanup immediately. By default, this endpoint:
  • stops all tracked persistent sessions
  • removes all isol8:* containers
  • removes all isol8:* images
​
images
boolean
Include Docker image cleanup. Defaults to true. Set false to clean sessions + containers only.
​
ok
boolean
true when cleanup completed.
​
sessions
object
Result summary for in-memory persistent sessions (removed, failed, errors).
​
containers
object
Result summary for container cleanup (removed, failed, errors).
​
images
object
Present when image cleanup runs; includes (removed, failed, errors).
curl -X POST http://localhost:3000/cleanup \
  -H "Authorization: Bearer $ISOL8_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "images": true }'

{
  "ok": true,
  "sessions": { "removed": 2, "failed": 0, "errors": [] },
  "containers": { "removed": 4, "failed": 0, "errors": [] },
  "images": { "removed": 5, "failed": 0, "errors": [] }
}
This endpoint is destructive. It removes all tracked sessions and all isol8:* containers (and images when enabled).