Issues and health

Issues combine deployment problems, incidents, domain failures, component health, and update advisories. Results are filtered to resources the caller can see.

List issues

const result = await ship.issues.list({ status: "open" });
console.log(result.issues, result.counts);

curl "$OPENSHIP_URL/api/issues?status=open" \
  -H "Authorization: Bearer $OPENSHIP_TOKEN"

status is open or resolved. The result contains issues, counts, and the selected status. Each issue includes its severity, source, target, message, and any supported resolution action. Counts are grouped as outage, actionRequired, advisory, and total.

Inspect workload health

const health = await ship.issues.health();
console.log(health.workloads, health.currentScan);

curl "$OPENSHIP_URL/api/issues/health" \
  -H "Authorization: Bearer $OPENSHIP_TOKEN"

The health snapshot includes workload observations, scan timing, and watcher capabilities. It does not start a continuous watcher. scanHealth() requests a fresh one-time check where the host supports it; native scheduling remains disabled unless explicitly configured.

Refresh issue sources

rescan() starts the broader rescan pipeline and requires job-write access. rescanStatus() reads the latest scan's stage statuses, summaries, and failures. Check the returned state before treating a scan as complete.

Operations