Remote cleanup

Trigger authenticated cleanup of sessions, containers, and optional images.

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).