Is Flexport API responding?
├── NO → Check status.flexport.com → Flexport outage → Enable circuit breaker
└── YES
    ├── Getting 401/403? → Key issue → Check API key, rotate if compromised
    ├── Getting 429? → Rate limited → Reduce concurrency, honor Retry-After
    ├── Getting 5xx? → Transient → Enable retry with backoff
    └── Data stale? → Webhook issue → Check webhook endpoint health

#!/bin/bash
echo "=== Flexport Incident Triage ==="

# Check API health
echo -n "API Status: "
curl -s -o /dev/null -w "%{http_code}" \
  -H "Authorization: Bearer $FLEXPORT_API_KEY" \
  -H "Flexport-Version: 2" \
  https://api.flexport.com/shipments?per=1
echo ""

# Check status page
echo -n "Platform: "
curl -s https://status.flexport.com/api/v2/status.json | jq -r '.status.description'

# Check error rates from your metrics
echo -n "Rate Limit Remaining: "
curl -s -H "Authorization: Bearer $FLEXPORT_API_KEY" \
  -H "Flexport-Version: 2" \
  https://api.flexport.com/shipments?per=1 -D - -o /dev/null 2>/dev/null | \
  grep -i "x-ratelimit-remaining" | awk '{print $2}'

class FlexportCircuitBreaker {
  private failures = 0;
  private lastFailure = 0;
  private state: 'closed' | 'open' | 'half-open' = 'closed';

  async execute<T>(fn: () => Promise<T>, fallback: () => T): Promise<T> {
    if (this.state === 'open') {
      if (Date.now() - this.lastFailure > 60_000) {
        this.state = 'half-open';  // Try again after 60s
      } else {
        return fallback();
      }
    }
    try {
      const result = await fn();
      this.failures = 0;
      this.state = 'closed';
      return result;
    } catch {
      this.failures++;
      this.lastFailure = Date.now();
      if (this.failures >= 3) this.state = 'open';
      return fallback();
    }
  }
}

// Usage: serve cached data when Flexport is down
const breaker = new FlexportCircuitBreaker();
const shipments = await breaker.execute(
  () => flexport('/shipments?per=100'),
  () => ({ data: { records: cachedShipments } }),  // Stale cache fallback
);

## Incident: [Title]
- **Duration**: [start] to [end]
- **Impact**: [affected shipments/users]
- **Root cause**: [Flexport outage / key expiry / webhook endpoint down]
- **Detection**: [alert / user report / monitoring]
- **Mitigation**: [circuit breaker / cache fallback / key rotation]
- **Action items**:
  - [ ] Improve monitoring for [specific metric]
  - [ ] Add circuit breaker to [specific endpoint]
  - [ ] Implement webhook replay for missed events