invoke-ai/InvokeAI · error · HTTPException

Failed to remove image from board

Error message

Failed to remove image from board

What it means

HTTP 500 raised by the DELETE /board_images/ endpoint when an unexpected exception escapes the board-image removal flow. The API wraps all non-HTTP exceptions from ApiDependencies.invoker.services.board_images.remove_image_from_board into a generic 500, so the real cause (DB error, service crash) is hidden in server logs.

Solutions

1. Check the server terminal logs for the underlying exception printed just before this 500
2. Verify the image_name exists (GET the image or list board images) before deleting
3. Confirm the database file/connection is healthy (permissions on invokeai.db, Postgres reachable)
4. Retry the delete; if the image was already removed, the failure is benign
5. Upgrade InvokeAI — several board_images race-condition bugs were fixed in later releases

Example fix

// before
await axios.delete(`/board_images/${imageName}/${boardId}`);
// after
try {
  await axios.delete(`/board_images/${imageName}/${boardId}`);
} catch (e) {
  if (e.response?.status === 500) console.error('check server logs for underlying cause', imageName);
  throw e;
}

const img = await api.get(`/images/${imageName}/metadata`).catch(() => null);
if (!img) console.warn('image already gone; skip removal');

const isHttpError = (e) => e && typeof e === 'object' && 'response' in e && e.response?.status !== undefined;

try {
  await api.delete(`/board_images/${imageName}/${boardId}`);
} catch (e) {
  if (e.response?.status === 500) {
    console.error('remove_image failed; inspect server logs for root cause', { imageName, boardId });
  }
  throw e;
}

When it happens

Trigger: DELETE /board_images/{image_name}/{board_id} where the image service throws while deleting the board-image association row — e.g. SQLite/Postgres connection failure, image_name not found mid-delete, or an internal service exception other than a known HTTPException.

Common situations: Database locked/corrupted SQLite file, stale image_name after gallery pruning, concurrent deletion of the same image, or an InvokeAI service dependency not initialized (rare misconfigured install).

Related errors

• Error retrieving recall parameters
• Failed to add images to board
• Failed to create board
• Failed to delete images
• Failed to get image DTOs

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

Appendix: source

Thrown at invokeai/app/api/routers/board_images.py:226

            outcome = _remove_from_board_and_classify(image_name, old_board_id)
            if outcome is _ScopedRemoveOutcome.REMOVED:
                removed_images.add(image_name)
                affected_boards.add("none")
                affected_boards.add(old_board_id)
            elif outcome is _ScopedRemoveOutcome.MOVED:
                failed_images.add(image_name)
            # GONE lands in neither list, matching the batch route's treatment of a name that
            # vanished mid-flight; the client's refetches surface the deletion.
        return RemoveImagesFromBoardResult(
            removed_images=list(removed_images),
            failed_images=list(failed_images),
            affected_boards=list(affected_boards),
        )

    except HTTPException:
        raise
    except Exception:
        raise HTTPException(status_code=500, detail="Failed to remove image from board")


@board_images_router.post(
    "/batch",
    operation_id="add_images_to_board",
    responses={
        201: {"description": "Images were added to board successfully"},
    },
    status_code=201,
    response_model=AddImagesToBoardResult,
)
def add_images_to_board(
    current_user: CurrentUserOrDefault,
    board_id: str = Body(description="The id of the board to add to"),
    image_names: list[ImageName] = Body(
        description="The names of the images to add", embed=True, max_length=MAX_IMAGE_BATCH_SIZE
    ),
) -> AddImagesToBoardResult:

View on GitHub (pinned to 0b6a024f2f)