🐛 Improve error message when receiving a 403

Author: patrick91

src/fastapi_cloud_cli/utils/api.py

@@ -209,6 +209,18 @@ def _handle_unauthorized(auth_mode: AuthMode) -> str:
     return message
 
 
+def _get_response_error_message(response: httpx.Response) -> str | None:
+    try:
+        data = response.json()
+    except json.JSONDecodeError:
+        return None
+
+    try:
+        return data["detail"]
+    except (KeyError, TypeError):
+        return None
+
+
 def handle_http_error(
     error: httpx.HTTPError,
     default_message: str | None = None,
@@ -227,7 +239,10 @@ def handle_http_error(
             message = _handle_unauthorized(auth_mode=auth_mode)
 
         elif status_code == 403:
-            message = "You don't have permissions for this resource"
+            message = (
+                _get_response_error_message(error.response)
+                or "You don't have permissions for this resource"
+            )
 
     if not message:
         message = (

tests/test_cli_deploy.py

@@ -461,6 +461,38 @@ def test_creates_app_on_backend(
         assert "App created successfully" in result.output
 
 
+@pytest.mark.respx
+def test_shows_api_message_when_create_app_is_forbidden(
+    logged_in_cli: None, tmp_path: Path, respx_mock: respx.MockRouter
+) -> None:
+    steps = [Keys.ENTER, Keys.ENTER, *"demo", Keys.ENTER, Keys.ENTER, Keys.ENTER]
+    team = _get_random_team()
+
+    respx_mock.get("/teams/").mock(
+        return_value=Response(200, json={"data": [team]})
+    )
+    respx_mock.post(
+        "/apps/", json={"name": "demo", "team_id": team["id"], "directory": None}
+    ).mock(
+        return_value=Response(
+            403,
+            json={"detail": "Your account cannot create apps for this team."},
+        )
+    )
+
+    with (
+        changing_dir(tmp_path),
+        patch("rich_toolkit.container.getchar") as mock_getchar,
+    ):
+        mock_getchar.side_effect = steps
+
+        result = runner.invoke(app, ["deploy"])
+
+    assert result.exit_code == 1
+    assert "You don't have permissions for this resource" in result.output
+    assert "API message: Your account cannot create apps for this team." in result.output
+
+
 @pytest.mark.respx
 def test_creates_app_with_directory(
     logged_in_cli: None, tmp_path: Path, respx_mock: respx.MockRouter