assemblyai-prod-checklist

# AssemblyAI Production Checklist ## Overview Complete checklist for deploying AssemblyAI-powered transcription services to production with health checks, monitoring, and rollback procedures. ## Prerequisites - Staging environment tested and verified - Production API key from https://www.assemblyai.com/app/account - Deployment pipeline configured - Monitoring stack ready ## Instructions ### Pre-Deployment Checklist #### API Key & Auth - [ ] Production API key stored in secrets manager (not env files) - [ ] Key is separate from dev/staging keys - [ ] Temporary token endpoint configured for browser streaming - [ ] API key rotation procedure documented #### Code Quality - [ ] All `transcript.status === 'error'` cases handled - [ ] Rate limit retry with exponential backoff implemented - [ ] No hardcoded API keys or audio URLs - [ ] PII redaction enabled for sensitive audio content - [ ] Webhook URL uses HTTPS - [ ] Audio file upload size validated before submission #### Error Handling - [ ] 429 (rate limit) triggers retry with backoff - [ ] 5xx (server error) triggers retry with backoff - [ ] 401 (auth error) triggers alert, no retry - [ ] `transcript.status === 'error'` logged with transcript ID and error message - [ ] WebSocket disconnect triggers reconnection for streaming - [ ] LeMUR errors handled (invalid transcript ID, context too long) #### Performance - [ ] Transcript results cached where appropriate - [ ] Concurrent transcription jobs limited via queue (p-queue ...