pygeai 0.6.0b6__py3-none-any.whl → 0.6.0b7__py3-none-any.whl

pygeai/core/utils/parsers.py

@@ -0,0 +1,32 @@
+from json import JSONDecodeError
+
+from pygeai import logger
+from pygeai.core.common.exceptions import InvalidAPIResponseException
+
+
+def parse_json_response(response, operation: str, **context):
+    """
+    Parse JSON response with standardized error handling.
+
+    :param response: HTTP response object
+    :param operation: Description of operation (e.g., "get project API token")
+    :param context: Additional context (e.g., api_token_id="123")
+    :return: Parsed JSON response
+    :raises InvalidAPIResponseException: If JSON parsing fails
+    """
+    try:
+        return response.json()
+    except JSONDecodeError as e:
+        full_msg = f"Unable to {operation}"
+        if context:
+            if len(context) == 1:
+                # Single context value: append as 'value'
+                value = list(context.values())[0]
+                full_msg += f" '{value}'"
+            else:
+                # Multiple context values: format as (key1='value1', key2='value2')
+                context_str = ", ".join([f"{k}='{v}'" for k, v in context.items()])
+                full_msg += f" ({context_str})"
+
+        logger.error(f"{full_msg}: JSON parsing error (status {response.status_code}): {e}. Response: {response.text}")
+        raise InvalidAPIResponseException(f"{full_msg}: {response.text}")

pygeai/core/utils/validators.py

@@ -0,0 +1,10 @@
+from pygeai import logger
+from pygeai.core.common.exceptions import APIResponseError
+
+
+def validate_status_code(response):
+    if response.status_code >= 300:
+        logger.error(f"Invalid status code returned from the API endpoint: {response.text}")
+        raise APIResponseError(f"API returned an error: {response.text}")
+
+

pygeai/evaluation/clients.py

@@ -2,6 +2,7 @@ from pygeai.core.base.clients import BaseClient
 from pygeai.core.base.session import Session
 from pygeai.core.common.exceptions import MissingRequirementException
 from pygeai.core.services.rest import ApiService
+from pygeai.core.utils.validators import validate_status_code
 
 
 class EvaluationClient(BaseClient):

pygeai/evaluation/dataset/clients.py

@@ -9,6 +9,7 @@ from pygeai.evaluation.dataset.endpoints import (
     CREATE_FILTER_VARIABLE, LIST_FILTER_VARIABLES, GET_FILTER_VARIABLE, UPDATE_FILTER_VARIABLE, DELETE_FILTER_VARIABLE,
     UPLOAD_DATASET_ROWS_FILE
 )
+from pygeai.core.utils.validators import validate_status_code
 
 
 class EvaluationDatasetClient(EvaluationClient):

pygeai/evaluation/plan/clients.py

@@ -5,6 +5,7 @@ from pygeai.evaluation.plan.endpoints import LIST_EVALUATION_PLANS, CREATE_EVALU
     UPDATE_EVALUATION_PLAN, DELETE_EVALUATION_PLAN, LIST_EVALUATION_PLAN_SYSTEM_METRICS, \
     ADD_EVALUATION_PLAN_SYSTEM_METRIC, GET_EVALUATION_PLAN_SYSTEM_METRIC, UPDATE_EVALUATION_PLAN_SYSTEM_METRIC, \
     DELETE_EVALUATION_PLAN_SYSTEM_METRIC, LIST_SYSTEM_METRICS, GET_SYSTEM_METRIC, EXECUTE_EVALUATION_PLAN
+from pygeai.core.utils.validators import validate_status_code
 
 
 class EvaluationPlanClient(EvaluationClient):

pygeai/evaluation/result/clients.py

@@ -2,6 +2,7 @@ import json
 
 from pygeai.evaluation.clients import EvaluationClient
 from pygeai.evaluation.result.endpoints import LIST_EVALUATION_RESULTS, GET_EVALUATION_RESULT
+from pygeai.core.utils.validators import validate_status_code
 
 
 class EvaluationResultClient(EvaluationClient):

pygeai/gam/clients.py

@@ -1,8 +1,9 @@
-from json import JSONDecodeError
 
 from pygeai import logger
 from pygeai.core.base.clients import BaseClient
 from pygeai.core.common.exceptions import MissingRequirementException, InvalidAPIResponseException
+from pygeai.core.utils.validators import validate_status_code
+from pygeai.core.utils.parsers import parse_json_response
 from pygeai.gam.endpoints import GET_ACCESS_TOKEN_V2, GET_USER_INFO_V2, IDP_SIGNIN_V1
 
 
@@ -104,12 +105,7 @@ class GAMClient(BaseClient):
             headers=headers,
             form=True
         )
-        try:
-            result = response.json()
-            return result
-        except JSONDecodeError as e:
-            logger.error(f"Unable to get access token: JSON parsing error (status {response.status_code}): {e}. Response: {response.text}")
-            raise InvalidAPIResponseException(f"Unable to get access token: {response.text}")
+        return parse_json_response(response, "get access token")
 
     def get_user_info(
             self,
@@ -130,12 +126,7 @@ class GAMClient(BaseClient):
             endpoint=GET_USER_INFO_V2,
             headers=headers
         )
-        try:
-            result = response.json()
-            return result
-        except JSONDecodeError as e:
-            logger.error(f"Unable to get user info: JSON parsing error (status {response.status_code}): {e}. Response: {response.text}")
-            raise InvalidAPIResponseException(f"Unable to get user info: {response.text}")
+        return parse_json_response(response, "get user info")
 
     def refresh_access_token(
             self,
@@ -173,21 +164,11 @@ class GAMClient(BaseClient):
             headers=headers,
             form=True
         )
-        try:
-            result = response.json()
-            return result
-        except JSONDecodeError as e:
-            logger.error(f"Unable to refresh access token: JSON parsing error (status {response.status_code}): {e}. Response: {response.text}")
-            raise InvalidAPIResponseException(f"Unable to refresh access token: {response.text}")
+        return parse_json_response(response, "refresh access token")
 
     def get_authentication_types(self):
         response = self.api_service.get(
             endpoint=GET_ACCESS_TOKEN_V2,
             params={},
         )
-        try:
-            result = response.json()
-            return result
-        except JSONDecodeError as e:
-            logger.error(f"Unable to get authentication types: JSON parsing error (status {response.status_code}): {e}. Response: {response.text}")
-            raise InvalidAPIResponseException(f"Unable to get authentication types: {response.text}")
+        return parse_json_response(response, "get authentication types")

pygeai/health/clients.py

@@ -1,8 +1,9 @@
-from json import JSONDecodeError
 
 from pygeai import logger
 from pygeai.core.base.clients import BaseClient
 from pygeai.core.common.exceptions import InvalidAPIResponseException
+from pygeai.core.utils.validators import validate_status_code
+from pygeai.core.utils.parsers import parse_json_response
 from pygeai.health.endpoints import STATUS_CHECK_V1
 
 
@@ -19,9 +20,4 @@ class HealthClient(BaseClient):
         response = self.api_service.get(
             endpoint=endpoint
         )
-        try:
-            result = response.json()
-            return result
-        except JSONDecodeError as e:
-            logger.error(f"Unable to check API status: JSON parsing error (status {response.status_code}): {e}. Response: {response.text}")
-            raise InvalidAPIResponseException(f"Unable to check API status: {response.text}")
+        return parse_json_response(response, "check API status")

pygeai/lab/agents/clients.py

@@ -1,10 +1,11 @@
-from json import JSONDecodeError
 from typing import Optional, List, Dict
 
 from pygeai import logger
 from pygeai.core.common.exceptions import MissingRequirementException, InvalidAPIResponseException
+from pygeai.core.utils.validators import validate_status_code
+from pygeai.core.utils.parsers import parse_json_response
 from pygeai.lab.agents.endpoints import CREATE_AGENT_V2, LIST_AGENTS_V2, GET_AGENT_V2, CREATE_SHARING_LINK_V2, \
-    PUBLISH_AGENT_REVISION_V2, DELETE_AGENT_V2, UPDATE_AGENT_V2, UPSERT_AGENT_V2, EXPORT_AGENT_V2, IMPORT_AGENT_V2
+    PUBLISH_AGENT_REVISION_V2, DELETE_AGENT_V2, UPDATE_AGENT_V2, UPSERT_AGENT_V2, EXPORT_AGENT_V4, IMPORT_AGENT_V4
 from pygeai.lab.constants import VALID_ACCESS_SCOPES
 from pygeai.lab.clients import AILabClient
 
@@ -52,13 +53,7 @@ class AgentClient(AILabClient):
                 "allowExternal": allow_external
             }
         )
-        try:
-            result = response.json()
-        except JSONDecodeError as e:
-            logger.error(f"Unable to list agents for project {self.project_id}: JSON parsing error (status {response.status_code}): {e}. Response: {response.text}")
-            raise InvalidAPIResponseException(f"Unable to list agents for project {self.project_id}: {response.text}")
-
-        return result
+        return parse_json_response(response, f"list agents for project {self.project_id}")
 
     def create_agent(
             self,
@@ -139,13 +134,8 @@ class AgentClient(AILabClient):
             data=data
         )
 
-        try:
-            result = response.json()
-        except JSONDecodeError as e:
-            logger.error(f"Unable to create agent for project {self.project_id}: JSON parsing error (status {response.status_code}): {e}. Response: {response.text}")
-            raise InvalidAPIResponseException(f"Unable to create agent for project {self.project_id}: {response.text}")
+        return parse_json_response(response, f"create agent for project {self.project_id}")
 
-        return result
 
     def get_agent(
             self,
@@ -185,13 +175,8 @@ class AgentClient(AILabClient):
                 "allowDrafts": allow_drafts,
             }
         )
-        try:
-            result = response.json()
-        except JSONDecodeError as e:
-            logger.error(f"Unable to retrieve agent {agent_id} for project {self.project_id}: JSON parsing error (status {response.status_code}): {e}. Response: {response.text}")
-            raise InvalidAPIResponseException(f"Unable to retrieve agent {agent_id} for project {self.project_id}: {response.text}")
+        return parse_json_response(response, f"retrieve agent {agent_id} for project {self.project_id}")
 
-        return result
 
     def create_sharing_link(
             self,
@@ -221,13 +206,8 @@ class AgentClient(AILabClient):
             headers=headers,
             params={}
         )
-        try:
-            result = response.json()
-        except JSONDecodeError as e:
-            logger.error(f"Unable to create sharing link for agent {agent_id} in project {self.project_id}: JSON parsing error (status {response.status_code}): {e}. Response: {response.text}")
-            raise InvalidAPIResponseException(f"Unable to create sharing link for agent {agent_id} in project {self.project_id}: {response.text}")
+        return parse_json_response(response, f"create sharing link for agent {agent_id} in project {self.project_id}")
 
-        return result
 
     def publish_agent_revision(
             self,
@@ -257,13 +237,8 @@ class AgentClient(AILabClient):
                 "revision": revision,
             }
         )
-        try:
-            result = response.json()
-        except JSONDecodeError as e:
-            logger.error(f"Unable to publish revision {revision} for agent {agent_id} in project {self.project_id}: JSON parsing error (status {response.status_code}): {e}. Response: {response.text}")
-            raise InvalidAPIResponseException(f"Unable to publish revision {revision} for agent {agent_id} in project {self.project_id}: {response.text}")
+        return parse_json_response(response, f"publish revision {revision} for agent {agent_id} in project {self.project_id}")
 
-        return result
 
     def delete_agent(
             self,
@@ -381,13 +356,8 @@ class AgentClient(AILabClient):
             data=data
         )
 
-        try:
-            result = response.json()
-        except JSONDecodeError as e:
-            logger.error(f"Unable to update agent {agent_id} in project {self.project_id}: JSON parsing error (status {response.status_code}): {e}. Response: {response.text}")
-            raise InvalidAPIResponseException(f"Unable to update agent {agent_id} in project {self.project_id}: {response.text}")
+        return parse_json_response(response, f"update agent {agent_id} in project {self.project_id}")
 
-        return result
 
     def export_agent(
             self,
@@ -404,7 +374,7 @@ class AgentClient(AILabClient):
         if not agent_id:
             raise MissingRequirementException("agent_id must be specified in order to export the agent")
 
-        endpoint = EXPORT_AGENT_V2.format(agentId=agent_id)
+        endpoint = EXPORT_AGENT_V4.format(agentId=agent_id)
         headers = {
             "Authorization": self.api_service.token,
             "ProjectId": self.project_id
@@ -416,13 +386,8 @@ class AgentClient(AILabClient):
             endpoint=endpoint,
             headers=headers,
         )
-        try:
-            result = response.json()
-        except JSONDecodeError as e:
-            logger.error(f"Unable to export agent {agent_id} for project {self.project_id}: JSON parsing error (status {response.status_code}): {e}. Response: {response.text}")
-            raise InvalidAPIResponseException(f"Unable to export agent {agent_id} for project {self.project_id}: {response.text}")
+        return parse_json_response(response, f"export agent {agent_id} for project {self.project_id}")
 
-        return result
 
     def import_agent(
             self,
@@ -439,7 +404,7 @@ class AgentClient(AILabClient):
         if not data:
             raise MissingRequirementException("data for spec must be specified in order to import the agent")
 
-        endpoint = IMPORT_AGENT_V2
+        endpoint = IMPORT_AGENT_V4
         headers = {
             "Authorization": self.api_service.token,
             "ProjectId": self.project_id
@@ -450,10 +415,5 @@ class AgentClient(AILabClient):
             headers=headers,
             data=data
         )
-        try:
-            result = response.json()
-        except JSONDecodeError as e:
-            logger.error(f"Unable to import agent for project {self.project_id}: JSON parsing error (status {response.status_code}): {e}. Response: {response.text}")
-            raise InvalidAPIResponseException(f"Unable to import agent for project {self.project_id}: {response.text}")
+        return parse_json_response(response, f"import agent for project {self.project_id}")
 
-        return result

pygeai/lab/agents/endpoints.py

@@ -8,3 +8,5 @@ UPDATE_AGENT_V2 = "v2/agents/{agentId}"  # PUT -> Update agent
 UPSERT_AGENT_V2 = "v2/agents/{agentId}/upsert"  # PUT -> Update or Insert agent
 EXPORT_AGENT_V2 = "v2/agents/{agentId}/export"  # GET -> Export agent
 IMPORT_AGENT_V2 = "v2/agents/import"  # POST -> Import agent
+EXPORT_AGENT_V4 = "v4/agents/{agentId}/export"  # GET -> Export agent
+IMPORT_AGENT_V4 = "v4/agents/import"  # POST -> Import agent

pygeai/lab/clients.py

@@ -2,6 +2,7 @@ from pygeai import logger
 from pygeai.admin.clients import AdminClient
 from pygeai.core.base.clients import BaseClient
 from pygeai.core.common.exceptions import APIError
+from pygeai.core.utils.validators import validate_status_code
 
 
 class AILabClient(BaseClient):

pygeai/lab/processes/clients.py

@@ -1,8 +1,9 @@
-from json import JSONDecodeError
 from typing import List
 
 from pygeai import logger
 from pygeai.core.common.exceptions import InvalidAPIResponseException
+from pygeai.core.utils.validators import validate_status_code
+from pygeai.core.utils.parsers import parse_json_response
 from pygeai.lab.processes.endpoints import CREATE_PROCESS_V2, UPDATE_PROCESS_V2, UPSERT_PROCESS_V2, GET_PROCESS_V2, \
     LIST_PROCESSES_V2, LIST_PROCESS_INSTANCES_V2, DELETE_PROCESS_V2, PUBLISH_PROCESS_REVISION_V2, CREATE_TASK_V2, \
     UPDATE_TASK_V2, UPSERT_TASK_V2, GET_TASK_V2, LIST_TASKS_V2, DELETE_TASK_V2, PUBLISH_TASK_REVISION_V2, \
@@ -84,13 +85,8 @@ class AgenticProcessClient(AILabClient):
         logger.debug(f"Creating agentic process with data: {data}")
 
         response = self.api_service.post(endpoint=endpoint, headers=headers, data=data)
-        try:
-            result = response.json()
-        except JSONDecodeError as e:
-            logger.error(f"Unable to create process for project {self.project_id}: JSON parsing error (status {response.status_code}): {e}. Response: {response.text}")
-            raise InvalidAPIResponseException(f"Unable to create process for project {self.project_id}: {response.text}")
+        return parse_json_response(response, f"create process for project {self.project_id}")
 
-        return result
 
     def update_process(
             self,
@@ -194,13 +190,8 @@ class AgenticProcessClient(AILabClient):
             headers=headers,
             data=data
         )
-        try:
-            result = response.json()
-        except JSONDecodeError as e:
-            logger.error(f"Unable to update process {process_id or name} in project {self.project_id}: JSON parsing error (status {response.status_code}): {e}. Response: {response.text}")
-            raise InvalidAPIResponseException(f"Unable to update process {process_id or name} in project {self.project_id}: {response.text}")
+        return parse_json_response(response, f"update process {process_id or name} in project {self.project_id}")
 
-        return result
 
     def get_process(
             self,
@@ -248,13 +239,8 @@ class AgenticProcessClient(AILabClient):
             headers=headers,
             params=params
         )
-        try:
-            result = response.json()
-        except JSONDecodeError as e:
-            logger.error(f"Unable to retrieve process {process_id or process_name} for project {self.project_id}: JSON parsing error (status {response.status_code}): {e}. Response: {response.text}")
-            raise InvalidAPIResponseException(f"Unable to retrieve process {process_id or process_name} for project {self.project_id}: {response.text}")
+        return parse_json_response(response, f"retrieve process {process_id or process_name} for project {self.project_id}")
 
-        return result
 
     def list_processes(
             self,
@@ -301,13 +287,8 @@ class AgenticProcessClient(AILabClient):
             headers=headers,
             params=params
         )
-        try:
-            result = response.json()
-        except JSONDecodeError as e:
-            logger.error(f"Unable to list processes for project {self.project_id}: JSON parsing error (status {response.status_code}): {e}. Response: {response.text}")
-            raise InvalidAPIResponseException(f"Unable to list processes for project {self.project_id}: {response.text}")
+        return parse_json_response(response, f"list processes for project {self.project_id}")
 
-        return result
 
     def list_process_instances(
             self,
@@ -348,13 +329,8 @@ class AgenticProcessClient(AILabClient):
             headers=headers,
             params=params
         )
-        try:
-            result = response.json()
-        except JSONDecodeError as e:
-            logger.error(f"Unable to list process instances for process {process_id} in project {self.project_id}: JSON parsing error (status {response.status_code}): {e}. Response: {response.text}")
-            raise InvalidAPIResponseException(f"Unable to list process instances for process {process_id} in project {self.project_id}: {response.text}")
+        return parse_json_response(response, f"list process instances for process {process_id} in project {self.project_id}")
 
-        return result
 
     def delete_process(
             self,
@@ -435,13 +411,8 @@ class AgenticProcessClient(AILabClient):
                 "revision": revision
             }
         )
-        try:
-            result = response.json()
-        except JSONDecodeError as e:
-            logger.error(f"Unable to publish revision {revision} for process {process_id or process_name} in project {self.project_id}: JSON parsing error (status {response.status_code}): {e}. Response: {response.text}")
-            raise InvalidAPIResponseException(f"Unable to publish revision {revision} for process {process_id or process_name} in project {self.project_id}: {response.text}")
+        return parse_json_response(response, f"publish revision {revision} for process {process_id or process_name} in project {self.project_id}")
 
-        return result
 
     def create_task(
             self,
@@ -495,12 +466,7 @@ class AgenticProcessClient(AILabClient):
         logger.debug(f"Creating task with data: {data}")
 
         response = self.api_service.post(endpoint=endpoint, headers=headers, data=data)
-        try:
-            return response.json()
-        except JSONDecodeError as e:
-            logger.error(f"Unable to create task for project {self.project_id}: JSON parsing error (status {response.status_code}): {e}. Response: {response.text}")
-            raise InvalidAPIResponseException(f"Unable to create task for project {self.project_id}: {response.text}")
-
+        return parse_json_response(response, f"create task for project {self.project_id}")
     def get_task(
             self,
             task_id: str,
@@ -531,12 +497,7 @@ class AgenticProcessClient(AILabClient):
             logger.debug(f"Retrieving task detail with name {task_name}")
 
         response = self.api_service.get(endpoint=endpoint, headers=headers)
-        try:
-            return response.json()
-        except JSONDecodeError as e:
-            logger.error(f"Unable to retrieve task {task_id or task_name} for project {self.project_id}: JSON parsing error (status {response.status_code}): {e}. Response: {response.text}")
-            raise InvalidAPIResponseException(f"Unable to retrieve task {task_id or task_name} for project {self.project_id}: {response.text}")
-
+        return parse_json_response(response, f"retrieve task {task_id or task_name} for project {self.project_id}")
     def list_tasks(
             self,
             id: str = None,
@@ -570,12 +531,7 @@ class AgenticProcessClient(AILabClient):
         logger.debug(f"Listing tasks for project with ID {self.project_id}")
 
         response = self.api_service.get(endpoint=endpoint, headers=headers, params=params)
-        try:
-            return response.json()
-        except JSONDecodeError as e:
-            logger.error(f"Unable to list tasks for project {self.project_id}: JSON parsing error (status {response.status_code}): {e}. Response: {response.text}")
-            raise InvalidAPIResponseException(f"Unable to list tasks for project {self.project_id}: {response.text}")
-
+        return parse_json_response(response, f"list tasks for project {self.project_id}")
     def update_task(
             self,
             task_id: str,
@@ -638,12 +594,7 @@ class AgenticProcessClient(AILabClient):
         logger.debug(f"Updating task with ID {task_id} with data: {data}")
 
         response = self.api_service.put(endpoint=endpoint, headers=headers, data=data)
-        try:
-            return response.json()
-        except JSONDecodeError as e:
-            logger.error(f"Unable to update task {task_id} in project {self.project_id}: JSON parsing error (status {response.status_code}): {e}. Response: {response.text}")
-            raise InvalidAPIResponseException(f"Unable to update task {task_id} in project {self.project_id}: {response.text}")
-
+        return parse_json_response(response, f"update task {task_id} in project {self.project_id}")
     def delete_task(
             self,
             task_id: str,
@@ -720,12 +671,7 @@ class AgenticProcessClient(AILabClient):
             logger.debug(f"Publishing revision {revision} for task with name {task_name}")
 
         response = self.api_service.post(endpoint=endpoint, headers=headers, data=data)
-        try:
-            return response.json()
-        except JSONDecodeError as e:
-            logger.error(f"Unable to publish revision {revision} for task {task_id or task_name} in project {self.project_id}: JSON parsing error (status {response.status_code}): {e}. Response: {response.text}")
-            raise InvalidAPIResponseException(f"Unable to publish revision {revision} for task {task_id or task_name} in project {self.project_id}: {response.text}")
-
+        return parse_json_response(response, f"publish revision {revision} for task {task_id or task_name} in project {self.project_id}")
     def start_instance(
             self,
             process_name: str,
@@ -761,12 +707,7 @@ class AgenticProcessClient(AILabClient):
         logger.info(f"Starting instance for process with name '{process_name}'")
 
         response = self.api_service.post(endpoint=endpoint, headers=headers, data=data)
-        try:
-            return response.json()
-        except JSONDecodeError as e:
-            logger.error(f"Unable to start instance for process {process_name} in project {self.project_id}: JSON parsing error (status {response.status_code}): {e}. Response: {response.text}")
-            raise InvalidAPIResponseException(f"Unable to start instance for process {process_name} in project {self.project_id}: {response.text}")
-
+        return parse_json_response(response, f"start instance for process {process_name} in project {self.project_id}")
     def abort_instance(
             self,
             instance_id: str
@@ -793,12 +734,7 @@ class AgenticProcessClient(AILabClient):
         logger.info(f"Aborting instance with ID '{instance_id}'")
 
         response = self.api_service.post(endpoint=endpoint, headers=headers, data={})
-        try:
-            return response.json()
-        except JSONDecodeError as e:
-            logger.error(f"Unable to abort instance {instance_id} in project {self.project_id}: JSON parsing error (status {response.status_code}): {e}. Response: {response.text}")
-            raise InvalidAPIResponseException(f"Unable to abort instance {instance_id} in project {self.project_id}: {response.text}")
-
+        return parse_json_response(response, f"abort instance {instance_id} in project {self.project_id}")
     def get_instance(
             self,
             instance_id: str
@@ -823,12 +759,7 @@ class AgenticProcessClient(AILabClient):
         logger.info(f"Retrieving instance detail with ID '{instance_id}'")
 
         response = self.api_service.get(endpoint=endpoint, headers=headers)
-        try:
-            return response.json()
-        except JSONDecodeError as e:
-            logger.error(f"Unable to retrieve instance {instance_id} for project {self.project_id}: JSON parsing error (status {response.status_code}): {e}. Response: {response.text}")
-            raise InvalidAPIResponseException(f"Unable to retrieve instance {instance_id} for project {self.project_id}: {response.text}")
-
+        return parse_json_response(response, f"retrieve instance {instance_id} for project {self.project_id}")
     def get_instance_history(
             self,
             instance_id: str
@@ -853,12 +784,7 @@ class AgenticProcessClient(AILabClient):
         logger.info(f"Retrieving instance history with ID '{instance_id}'")
 
         response = self.api_service.get(endpoint=endpoint, headers=headers)
-        try:
-            return response.json()
-        except JSONDecodeError as e:
-            logger.error(f"Unable to retrieve history for instance {instance_id} in project {self.project_id}: JSON parsing error (status {response.status_code}): {e}. Response: {response.text}")
-            raise InvalidAPIResponseException(f"Unable to retrieve history for instance {instance_id} in project {self.project_id}: {response.text}")
-
+        return parse_json_response(response, f"retrieve history for instance {instance_id} in project {self.project_id}")
     def get_thread_information(
             self,
             thread_id: str
@@ -883,12 +809,7 @@ class AgenticProcessClient(AILabClient):
         logger.debug(f"Retrieving information about thread with ID {thread_id}")
 
         response = self.api_service.get(endpoint=endpoint, headers=headers)
-        try:
-            return response.json()
-        except JSONDecodeError as e:
-            logger.error(f"Unable to retrieve thread information for thread {thread_id} in project {self.project_id}: JSON parsing error (status {response.status_code}): {e}. Response: {response.text}")
-            raise InvalidAPIResponseException(f"Unable to retrieve thread information for thread {thread_id} in project {self.project_id}: {response.text}")
-
+        return parse_json_response(response, f"retrieve thread information for thread {thread_id} in project {self.project_id}")
     def send_user_signal(
             self,
             instance_id: str,
@@ -922,12 +843,7 @@ class AgenticProcessClient(AILabClient):
         logger.debug(f"Sending user signal to process instance with ID {instance_id} with data: {data}")
 
         response = self.api_service.post(endpoint=endpoint, headers=headers, data=data)
-        try:
-            return response.json()
-        except JSONDecodeError as e:
-            logger.error(f"Unable to send user signal {signal_name} to instance {instance_id} in project {self.project_id}: JSON parsing error (status {response.status_code}): {e}. Response: {response.text}")
-            raise InvalidAPIResponseException(f"Unable to send user signal {signal_name} to instance {instance_id} in project {self.project_id}: {response.text}")
-
+        return parse_json_response(response, f"send user signal {signal_name} to instance {instance_id} in project {self.project_id}")
     def create_kb(
             self,
             name: str,
@@ -967,12 +883,7 @@ class AgenticProcessClient(AILabClient):
             headers=headers,
             data=data
         )
-        try:
-            return response.json()
-        except JSONDecodeError as e:
-            logger.error(f"Unable to create knowledge base for project {self.project_id}: JSON parsing error (status {response.status_code}): {e}. Response: {response.text}")
-            raise InvalidAPIResponseException(f"Unable to create knowledge base for project {self.project_id}: {response.text}")
-
+        return parse_json_response(response, f"create knowledge base for project {self.project_id}")
     def get_kb(
             self,
             kb_id: str = None,
@@ -1003,12 +914,8 @@ class AgenticProcessClient(AILabClient):
             logger.debug(f"Retrieving KB detail with name {kb_name}")
 
         response = self.api_service.get(endpoint=endpoint, headers=headers)
-        try:
-            return response.json()
-        except JSONDecodeError as e:
-            logger.error(f"Unable to retrieve knowledge base {kb_id or kb_name} for project {self.project_id}: JSON parsing error (status {response.status_code}): {e}. Response: {response.text}")
-            raise InvalidAPIResponseException(f"Unable to retrieve knowledge base {kb_id or kb_name} for project {self.project_id}: {response.text}")
-
+        kb_identifier = kb_id or kb_name
+        return parse_json_response(response, f"retrieve knowledge base {kb_identifier} for project {self.project_id}")
     def list_kbs(
             self,
             name: str = None,
@@ -1039,12 +946,7 @@ class AgenticProcessClient(AILabClient):
         logger.debug(f"Listing tasks in project with ID {self.project_id}")
 
         response = self.api_service.get(endpoint=endpoint, headers=headers, params=params)
-        try:
-            return response.json()
-        except JSONDecodeError as e:
-            logger.error(f"Unable to list knowledge bases for project {self.project_id}: JSON parsing error (status {response.status_code}): {e}. Response: {response.text}")
-            raise InvalidAPIResponseException(f"Unable to list knowledge bases for project {self.project_id}: {response.text}")
-
+        return parse_json_response(response, f"list knowledge bases for project {self.project_id}")
     def delete_kb(
             self,
             kb_id: str = None,
@@ -1124,10 +1026,5 @@ class AgenticProcessClient(AILabClient):
             headers=headers,
             params=params
         )
-        try:
-            result = response.json()
-        except JSONDecodeError as e:
-            logger.error(f"Unable to list jobs for project {self.project_id}: JSONDecodeError parsing error (status {response.status_code}): {e}. Response: {response.text}")
-            raise InvalidAPIResponseException(f"Unable to list jobs for project {self.project_id}: {response.text}")
+        return parse_json_response(response, f"list jobs for project {self.project_id}")
 
-        return result