invoke-ai/InvokeAI · error · HTTPException

Failed to unstar images

Error message

Failed to unstar images

What it means

HTTP 500 raised by POST /images/unstar when unstarring the listed image_names throws an unexpected exception. Symmetric with the star endpoint: per-image problems land in failed_images; this detail means an unhandled service error occurred.

Solutions

1. Check server logs for the root exception
2. Refresh the image list and retry only existing image names
3. Retry with a smaller batch to find the failing image
4. Restart InvokeAI if the DB lock persists

const existing = new Set((await api.getImageDtos(imageNames)).map(i => i.image_name));
const validNames = imageNames.filter(n => existing.has(n));

try {
  const res = await api.unstarImagesInList(validNames);
} catch (e) {
  if (e instanceof ApiError && e.status === 500) {
    // retry with smaller batches; consult server logs
  }
}

When it happens

Trigger: POST /api/v1/images/unstar with image_names whose records cannot be read or updated by the images service (DB error, storage failure, corrupt records).

Common situations: Concurrent modification of the same images by queue workers; sqlite 'database is locked' during bulk updates; stale image names after external DB manipulation.

Related errors

• Failed to delete images
• Failed to get image DTOs
• Failed to get intermediates
• Failed to remove image from board
• Failed to star images

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

Appendix: source

Thrown at invokeai/app/api/routers/images.py:749

                )
                unstarred_images.add(image_name)
                affected_boards.add(updated_image_dto.board_id or "none")
            except HTTPException:
                continue
            except ImageRecordNotFoundException:
                # See star_images_in_list.
                continue
            except Exception:
                failed_images.add(image_name)
        return UnstarredImagesResult(
            unstarred_images=list(unstarred_images),
            failed_images=list(failed_images),
            affected_boards=list(affected_boards),
        )
    except HTTPException:
        raise
    except Exception:
        raise HTTPException(status_code=500, detail="Failed to unstar images")


class ImagesDownloaded(BaseModel):
    response: Optional[str] = Field(
        default=None, description="The message to display to the user when images begin downloading"
    )
    bulk_download_item_name: Optional[str] = Field(
        default=None, description="The name of the bulk download item for which events will be emitted"
    )


@images_router.post(
    "/download", operation_id="download_images_from_list", response_model=ImagesDownloaded, status_code=202
)
def download_images_from_list(
    current_user: CurrentUserOrDefault,
    background_tasks: BackgroundTasks,
    image_names: Optional[list[ImageName]] = Body(

View on GitHub (pinned to 0b6a024f2f)