REST API reference

Diagnose a training log. Returns root cause, classification, originating rank (if distributed), and the exact fix.

{ logs: string, jobName?: string }

{ success: true, diagnosisTimeMs: number, fix: { summary, action, resumeFrom? }, meta: { failureType, confidence, source, ... } }

Recent diagnoses for the authenticated user. Default limit 50.

{ history: Diagnosis[] }

Remaining diagnoses for today. Free plan only; paid plans return unlimited.

{ quota: { remaining, limit, used } }

Thumbs-up / thumbs-down feedback on a diagnosis. Confirmed fixes are added to the team knowledge base.

{ id: string, helpful: boolean, comment?: string }

Agent heartbeat. Reports job status every 30s.

{ jobName, hostname, status, ts }

Agent crash report. Ships the last 500 log lines on non-zero exit. Mass-crash safe: reports sharing a cluster + failure signature within 5 minutes coalesce into ONE diagnosis — followers return the shared fix with coalesced: true and consume no quota. See Rate limits for details.

{ runId?, jobName, logs, exitCode, meta? }

{ success: true, diagnosisId, coalesced?, crashCount?, fix: { summary, action, fallbackAction?, emergencyAction?, resumeFrom? }, meta: { failureType, confidence } }

List API keys for the authenticated user.

{ keys: ApiKey[] }

Create a new API key. The full key is returned only once.

{ label?: string }

List jobs the agent has reported heartbeats for.

{ jobs: Job[] }

List alert channels for the authenticated user.

{ channels: AlertChannel[] }

Add a new alert channel.

{ channelType: 'slack' | 'webhook' | 'sms' | 'pagerduty' | 'email', config: object, enabled?: boolean }

Remove an alert channel.

{ id: number }

Start a Stripe Checkout Session for a paid plan.

{ plan: 'team' | 'scale' }

{ url: string }

Current subscription, including plan, status, and period end.

{ plan, subscription: { id, plan, status, currentPeriodEnd, cancelAtPeriodEnd }, trial: { ... } | null }

Open the Stripe customer portal for self-service plan changes and invoice downloads.

{ url: string }

Stripe webhook. Handles checkout.session.completed and customer.subscription.* events.

Redeem a trial code. Each account may redeem one code.

{ code: string }