Class APIException

src/app/utils/exceptions.py:9–40

Base exception for all **handled/known** API errors. All user-facing error responses should inherit from this class (or use its subclasses) so they get consistent formatting.

class APIException(HTTPException):
    """
    Base exception for all **handled/known** API errors.

    All user-facing error responses should inherit from this class
    (or use its subclasses) so they get consistent formatting.
    """

    def __init__(
        self,
        status_code: int,
        detail: str,
        error_code: str | None = None,
        data: Any = None,
        headers: dict[str, str] | None = None,
    ):
        self.error_code = error_code or self.__class__.__name__.replace("Exception", "").upper()
        self.data = data

        # We put everything inside 'detail' so the frontend gets a rich object
        rich_detail = {
            "message": detail,
            "error_code": self.error_code,
        }
        if data is not None:
            rich_detail["data"] = data

        super().__init__(
            status_code=status_code,
            detail=rich_detail,
            headers=headers,
        )


# ────────────────────────────────────────