invoke-ai/InvokeAI · error · HTTPException

Failed to update video

Error message

Failed to update video

What it means

Raised by update_video (PATCH videos/i/{video_name}) as HTTP 400 when the service's update(video_name, video_changes) call raises any exception. It means the record exists and the caller passed the ownership check, but applying the changes failed — typically due to invalid field values in VideoRecordChanges or a database failure. The original exception is swallowed, so the server log is needed to learn the real cause.

Source

Thrown at invokeai/app/api/routers/videos.py:484

    return DeleteVideosResult(
        deleted_videos=list(deleted_videos),
        failed_videos=list(failed_videos),
        affected_boards=list(affected_boards),
    )


# Sync for the same reason as delete_video: the update is a blocking SQLite write.
@videos_router.patch("/i/{video_name}", operation_id="update_video", response_model=VideoDTO)
def update_video(
    current_user: CurrentUserOrDefault,
    video_name: str = PathParam(description="The name of the video to update"),
    video_changes: VideoRecordChanges = Body(description="The changes to apply to the video"),
) -> VideoDTO:
    _assert_video_owner(video_name, current_user)
    try:
        return ApiDependencies.invoker.services.videos.update(video_name, video_changes)
    except Exception:
        raise HTTPException(status_code=400, detail="Failed to update video")


@videos_router.get("/i/{video_name}", operation_id="get_video_dto", response_model=VideoDTO)
def get_video_dto(
    current_user: CurrentUserOrDefault,
    video_name: str = PathParam(description="The name of video to get"),
) -> VideoDTO:
    _assert_video_read_access(video_name, current_user)
    try:
        return ApiDependencies.invoker.services.videos.get_dto(video_name)
    except VideoRecordNotFoundException:
        # See get_image_dto: this is the 404 a workflow's video field drops its reference on,
        # so only a genuinely missing record may produce it.
        raise HTTPException(status_code=404)


@videos_router.get(
    "/i/{video_name}/metadata", operation_id="get_video_metadata", response_model=Optional[MetadataField]

View on GitHub (pinned to 0b6a024f2f)

Solutions

1. Inspect the server logs for the underlying exception raised by videos.update().
2. Validate the VideoRecordChanges payload: ensure board_id references an existing board and only allowed fields are set.
3. Re-fetch the video DTO (GET videos/i/{video_name}) and retry with a fresh, minimal changes object.
4. Check database health (locks, disk space) if the payload is valid but the error persists.

Example fix

// before: blind full-object patch with stale fields
await api.updateVideo(name, { ...oldDto, board_id: staleBoardId });
// after
const fresh = await api.getVideoDto(name);
await api.updateVideo(name, { board_id: await ensureBoardExists(targetBoardId) });

function validChanges(c) {
  return c && Object.keys(c).length > 0 &&
    (c.board_id === undefined || c.board_id === 'none' || typeof c.board_id === 'string');
}
if (!validChanges(changes)) throw new Error('Invalid VideoRecordChanges');

function isVideoRecordChanges(v) {
  return typeof v === 'object' && v !== null &&
    !('video_name' in v) && !('created_at' in v); // changes object, not a full DTO
}

try {
  return await api.updateVideo(name, changes);
} catch (e) {
  if (e.response?.status === 400) {
    const fresh = await api.getVideoDto(name);
    return api.updateVideo(name, { board_id: changes.board_id }); // minimal retry
  }
  throw e;
}

When it happens

Trigger: PATCH with a VideoRecordChanges payload containing invalid values (e.g. bad board_id, out-of-range fields), a DB write failure, or a concurrent modification conflict; also any unexpected exception inside the service update path.

Common situations: Client sending stale board_id after the board was deleted; malformed PATCH body shape; SQLite lock/disk issues; API version drift where the client sends fields the current schema rejects.

Related errors

• Video record not found
• Administrator account already configured
• Invalid preset data
• System prompt not found
• Video metadata not found

AI-assisted analysis of invoke-ai/InvokeAI@0b6a024f2f (2026-08-29). Data as JSON: /api/errors/12de3fd8b8e5b2ab. Report an issue: GitHub.