---
title: Error Handling
url: https://docs.kaltura.com/docs/conversational-agents/avatar-videos/error-handling
---

## Error Handling

### Server-Side API Errors

| Error Code | Meaning | Resolution |
|------------|---------|------------|
| `VIDEO_IS_PROCESSING` | Scenes cannot be modified while composing or generating (name and metadata updates are still allowed) | Wait for the current operation to complete |
| `VIDEO_CANNOT_COMPOSE` | Video status does not allow composition | Use `resetStatus` if in error state, or wait for current operation |
| `VIDEO_CANNOT_GENERATE` | Video status does not allow generation | Ensure video is in `draft` or `composed` status |
| `VIDEO_IS_BEING_GENERATED` | A generation is already in progress | Wait for it to complete |
| `CANNOT_RESET_STATUS` | Only error statuses can be reset | Only `compose-error` and `generate-error` can be reset |
| `SCENE_NOT_FOUND` | Scene index out of range | Check scene count in the video |
| `SCENE_EMPTY_NARRATION` | Scene has no narration text | Add narration text before previewing audio |
| `CAPTIONS_NOT_FOUND` | Source entries have no captions | Add captions/transcripts to source entries before composing |
| `TOO_MANY_SOURCES` | Too many unique b-roll source entries across all scenes | Reduce the number of distinct `entryId` values. Reuse entries at different `startTime` offsets instead of adding new sources |
| `AVATAR_NOT_FOUND` | Invalid avatar ID | Create an avatar with `avatar.upsert` first |
| `AVATAR_TEMPLATE_NOT_FOUND` | Invalid template ID | Use an ID from `avatarTemplate.list` |
| `BACKGROUND_NOT_FOUND` | Invalid library background ID | Use a valid background ID from the asset library |
| `VIDEO_AVATAR_NOT_CONFIGURED` | Video has no avatar set | Set `avatarId` when creating or updating the video |
| `INVALID_STATUS_TRANSITION` | Status change not allowed | Follow the status lifecycle diagram in section 3 |

### Widget Errors

- **Blank studio** — Verify the KS is valid and `partnerId` is a number (required type). Check browser console for API errors  
- **No avatars available** — Confirm the account has VOD Avatar feature provisioning  
- **Generation produces `generate-error`** — Isolate the cause: test a minimal 1-scene full-screen video first. If that succeeds, check b-roll entries for standard frame rates (25/30 fps) and confirm they are within the 5-source limit. If it also errors, retry later for a transient service issue  
- **KS expiry** — Update reactively: `workspace.session.setData(prev => ({ ...prev, ks: "new-ks" }))`