MCP housekeeping sweep (POST)

POST

/cron/mcp-retention-sweep

const url = 'https://example.com/api/cron/mcp-retention-sweep';
const options = {method: 'POST'};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request POST \
  --url https://example.com/api/cron/mcp-retention-sweep

Scheduled with ticket-email-digest (every 15m) via the mcp-retention stage in .slipstream.json (scripts/cron-mcp-retention-sweep.sh). Protected by CRON_SECRET via the x-cron-secret header only.

Responses

200

Per-sweep deleted / swept counters

application/json

object

required

False when the sweep threw; error then carries a short reason.

boolean

tool_calls_deleted

Rows deleted from mcp_tool_calls past the 30-day retention window.

integer

presence_rows_deleted

Stale mcp_session_machines presence rows deleted.

integer

session_defaults_swept

Expired per-session project defaults dropped (machine-local).

integer

in_flight_swept

Abandoned in-flight work entries dropped (machine-local).

integer

agent_sessions_swept

Stale agent sessions dropped from the in-process map (machine-local).

integer

worker_sessions_pruned

Stale agent-worker sessions pruned (machine-local).

integer

presence_throttle_entries_pruned

Expired presence write-throttle entries dropped (machine-local).

integer

work_segments_persisted

Work segments flushed to the database during the sweep.

integer

error

Short failure reason; present only when ok is false.

string

401

Missing or invalid CRON_SECRET