LLM-Driven Extraction of Unstructured Data — Built for API Deployments & ETL Pipeline Workflows
Python ai-agentsdata-engineeringdocument-aigenerative-aiidpjson-extractionllmmcp-serverocrpdf-extractionprompt-engineeringstructured-output
FEAT: Enhance API Deployment Validation to Return 4xx Instead of 500 for Errors (#890)
Praveen Kumarfdb5a0cb5e42
diff --git a/backend/api_v2/api_deployment_views.py b/backend/api_v2/api_deployment_views.pyindex fddf8d536..017ab4888 100644--- a/backend/api_v2/api_deployment_views.py+++ b/backend/api_v2/api_deployment_views.py@@ -11,6 +11,7 @@ from api_v2.serializers import (APIDeploymentListSerializer,APIDeploymentSerializer,DeploymentResponseSerializer,+ ExecutionQuerySerializer,ExecutionRequestSerializer,)from django.db.models import QuerySet@@ -73,16 +74,18 @@ class DeploymentExecution(views.APIView):def get(self, request: Request, org_name: str, api_name: str, api: APIDeployment) -> Response:- execution_id = request.query_params.get("execution_id")- include_metadata = (- request.query_params.get(ApiExecution.INCLUDE_METADATA, "false").lower()- == "true"- )- if not execution_id:- raise InvalidAPIRequest("execution_id shouldn't be empty")+ serializer = ExecutionQuerySerializer(data=request.query_params)+ serializer.is_valid(raise_exception=True)++ execution_id = serializer.validated_data.get(ApiExecution.EXECUTION_ID)+ include_metadata = serializer.validated_data.get(ApiExecution.INCLUDE_METADATA)++ # Fetch execution statusresponse: ExecutionResponse = DeploymentHelper.get_execution_status(- execution_id=execution_id+ execution_id)++ # Determine response statusresponse_status = status.HTTP_422_UNPROCESSABLE_ENTITYif response.execution_status == CeleryTaskState.COMPLETED.value:response_status = status.HTTP_200_OKdiff --git a/backend/api_v2/constants.py b/backend/api_v2/constants.pyindex 2de41efb2..7cdb3c8ba 100644--- a/backend/api_v2/constants.py+++ b/backend/api_v2/constants.py@@ -5,3 +5,4 @@ class ApiExecution:TIMEOUT_FORM_DATA: str = "timeout"INCLUDE_METADATA: str = "include_metadata"USE_FILE_HISTORY: str = "use_file_history" # Undocumented parameter+ EXECUTION_ID: str = "execution_id"diff --git a/backend/api_v2/serializers.py b/backend/api_v2/serializers.pyindex 655478e4b..8bcca93ae 100644--- a/backend/api_v2/serializers.py+++ b/backend/api_v2/serializers.py@@ -1,3 +1,4 @@+import uuidfrom collections import OrderedDictfrom typing import Any, Union@@ -15,6 +16,8 @@ from rest_framework.serializers import (ValidationError,)from utils.serializer.integrity_error_mixin import IntegrityErrorMixin+from workflow_manager.workflow_v2.exceptions import ExecutionDoesNotExistError+from workflow_manager.workflow_v2.models.execution import WorkflowExecutionfrom backend.serializers import AuditSerializer@@ -115,6 +118,32 @@ class ExecutionRequestSerializer(Serializer):use_file_history = BooleanField(default=False)+class ExecutionQuerySerializer(Serializer):+ execution_id = CharField(required=True)+ include_metadata = BooleanField(default=False)++ def validate_execution_id(self, value):+ """Trim spaces, validate UUID format, and check if execution_id exists."""+ value = value.strip()++ # Validate UUID format+ try:+ uuid_obj = uuid.UUID(value)+ except ValueError:+ raise ValidationError(+ f"Invalid execution_id '{value}'. Must be a valid UUID."+ )++ # Check if UUID exists in the database+ exists = WorkflowExecution.objects.filter(id=uuid_obj).exists()+ if not exists:+ raise ExecutionDoesNotExistError(+ f"Execution with ID '{value}' does not exist."+ )++ return str(uuid_obj)++class APIDeploymentListSerializer(ModelSerializer):workflow_name = CharField(source="workflow.workflow_name", read_only=True)diff --git a/backend/workflow_manager/workflow_v2/exceptions.py b/backend/workflow_manager/workflow_v2/exceptions.pyindex 39087ab8e..fa53b3023 100644--- a/backend/workflow_manager/workflow_v2/exceptions.py+++ b/backend/workflow_manager/workflow_v2/exceptions.py@@ -21,6 +21,11 @@ class WorkflowDoesNotExistError(APIException):default_detail = "Workflow does not exist"+class ExecutionDoesNotExistError(APIException):+ status_code = 404+ default_detail = "Execution does not exist."++class TaskDoesNotExistError(APIException):status_code = 404default_detail = "Task does not exist"diff --git a/backend/workflow_manager/workflow_v2/workflow_helper.py b/backend/workflow_manager/workflow_v2/workflow_helper.pyindex afb7962db..c2ecda704 100644--- a/backend/workflow_manager/workflow_v2/workflow_helper.py+++ b/backend/workflow_manager/workflow_v2/workflow_helper.py@@ -414,17 +414,18 @@ class WorkflowHelper:Raises:TaskDoesNotExistError: Not found exception+ ExecutionDoesNotExistError: If execution is not foundReturns:ExecutionResponse: _description_"""execution = WorkflowExecution.objects.get(id=execution_id)-if not execution.task_id:- raise TaskDoesNotExistError()+ raise TaskDoesNotExistError(+ f"No task ID found for execution: {execution_id}"+ )result = AsyncResult(str(execution.task_id))-task = AsyncResultData(async_result=result)# Prepare the initial response with the task's current status and result.