grammarly-incident-runbook

Grammarly Incident Runbook

Triage Steps

Step 1: Verify Outage

# Test API health
curl -s -o /dev/null -w "%{http_code}" \
  https://api.grammarly.com/ecosystem/api/v2/scores

# Test with auth
curl -s -w "\n%{http_code}" \
  -H "Authorization: Bearer $GRAMMARLY_ACCESS_TOKEN" \
  -X POST https://api.grammarly.com/ecosystem/api/v2/scores \
  -H "Content-Type: application/json" \
  -d '{"text": "Test sentence with enough words for minimum requirement for the Grammarly writing score API diagnostic check."}' 

Step 2: Classify Severity

Severity	Condition	Action
P1	API returns 5xx for all requests	Activate fallback, notify stakeholders
P2	Intermittent 5xx or high latency	Enable retry logic, monitor
P3	Specific endpoint failing	Route around, file support ticket

Step 3: Fallback Mode

async function scoreWithFallback(text: string, token: string) {
  try {
    return await grammarlyClient.score(text);
  } catch {
    console.warn('Grammarly API unavailable, returning placeholder');
    return { overallScore: -1, correctness: -1, clarity: -1, engagement: -1, tone: -1, fallback: true };
  }
}

Resources

• Grammarly Support