Merge pull request #1033 from tisnik/docstrings-for-endpoint-handlers

LCORE-1142: Docstrings for endpoint handlers

Author: tisnik

src/app/endpoints/authorized.py

@@ -31,6 +31,8 @@ async def authorized_endpoint_handler(
     Process POST requests to the /authorized endpoint, returning
     the authenticated user's ID and username.
 
+    The response intentionally omits any authentication token.
+
     Returns:
         AuthorizedResponse: Contains the user ID and username of the authenticated user.
     """

src/app/endpoints/config.py

@@ -44,6 +44,8 @@ async def config_endpoint_handler(
     Process GET requests to the /config endpoint and returns the
     current service configuration.
 
+    Ensures the application configuration is loaded before returning it.
+
     Returns:
         ConfigurationResponse: The loaded service configuration response.
     """

src/app/endpoints/info.py

@@ -44,6 +44,12 @@ async def info_endpoint_handler(
     Process GET requests to the /info endpoint, returning the
     service name, version and Llama-stack version.
 
+    Raises:
+        HTTPException: with status 500 and a detail object
+        containing `response` and `cause` when unable to connect to
+        Llama Stack. It can also return status 401 or 403 for
+        unauthorized access.
+
     Returns:
         InfoResponse: An object containing the service's name and version.
     """