Error Codes & Troubleshooting Guide

## Error Codes & Troubleshooting Guide When a publishing, rendering, or API operation encounters an issue, ESER AI records a clear, normalized error code with actionable resolution steps. --- ### Common Error Codes & Fixes #### 1. `TOKEN_EXPIRED` / `OAUTH_INVALID` - **Cause:** The social network's authorization token was revoked, expired, or the account password was changed. - **Resolution:** Navigate to **Settings -> Social Accounts**, locate the affected account, and click **Reconnect**. Complete the provider login to refresh the credentials. #### 2. `MEDIA_SPEC_INVALID` / `RESOLUTION_MISMATCH` - **Cause:** Uploaded media does not meet the destination platform's technical constraints (e.g., uploading a 16:9 video to a 9:16 Shorts slot, or an image file exceeding 50 MB). - **Resolution:** Ensure vertical reels are exactly 1080x1920 MP4, images are JPEG/PNG/WebP under 50 MB, and LinkedIn PDFs are under 100 pages. #### 3. `RATE_LIMIT_EXCEEDED` - **Cause:** You have reached the social platform's hourly or daily API publishing quota. - **Resolution:** ESER AI automatically queues your post with exponential backoff retry. No manual action is needed; the post will publish once the platform rate window resets. #### 4. `INSUFFICIENT_CREDITS` - **Cause:** Your workspace has exhausted its monthly AI generation credits for video, voice, or image rendering. - **Resolution:** Standard scheduling and publishing do not consume credits. To run additional AI video renders or voice synthesis, purchase a top-up pack under **Dashboard -> Billing -> Credits** ($12 per 1,000 credits). #### 5. `PROVIDER_SCOPES_MISSING` - **Cause:** During OAuth login, required permissions (such as Page Management or Video Upload) were unchecked in the provider dialog. - **Resolution:** Click **Reconnect** in Social Accounts and ensure all requested permission boxes remain checked.