@epilot/erp-integration-client 0.20.2 → 0.21.0

package/dist/openapi.json

@@ -2,7 +2,7 @@
   "openapi": "3.0.3",
   "info": {
     "title": "ERP Integration API",
-    "version": "0.35.0",
+    "version": "0.25.0",
     "description": "API for integrating with ERP systems, handling tracking acknowledgments, triggering ERP processes, and processing ERP updates."
   },
   "tags": [
@@ -128,7 +128,6 @@
     },
     "/v1/erp/updates/events": {
       "post": {
-        "deprecated": true,
         "operationId": "processErpUpdatesEvents",
         "summary": "processErpUpdatesEvents",
         "description": "Handles updates from ERP systems and tracks them appropriately",
@@ -215,6 +214,9 @@
           "401": {
             "$ref": "#/components/responses/Unauthorized"
           },
+          "422": {
+            "$ref": "#/components/responses/ERPUpdatesResponse"
+          },
           "500": {
             "$ref": "#/components/responses/InternalServerError"
           }
@@ -223,7 +225,6 @@
     },
     "/v2/erp/updates/events": {
       "post": {
-        "deprecated": true,
         "operationId": "processErpUpdatesEventsV2",
         "summary": "processErpUpdatesEventsV2",
         "description": "Handles updates from ERP systems using integration_id directly.\nThis is the v2 version that simplifies the API by accepting integration_id\ninstead of app_id and component_id.\n",
@@ -271,59 +272,9 @@
           "401": {
             "$ref": "#/components/responses/Unauthorized"
           },
-          "500": {
-            "$ref": "#/components/responses/InternalServerError"
-          }
-        }
-      }
-    },
-    "/v3/erp/updates/events": {
-      "post": {
-        "operationId": "processErpUpdatesEventsV3",
-        "summary": "processErpUpdatesEventsV3",
-        "description": "Handles updates from ERP systems using integration_id directly.\nThis is the v3 version that removes the unused event_type field and renames object_type to event_name\nto align with the integration UI naming.\n",
-        "tags": [
-          "erp"
-        ],
-        "requestBody": {
-          "content": {
-            "application/json": {
-              "schema": {
-                "$ref": "#/components/schemas/ErpUpdatesEventsV3Request"
-              },
-              "example": {
-                "integration_id": "123e4567-e89b-12d3-a456-426614174000",
-                "correlation_id": "req-789e4567-e89b-12d3-a456-426614174000",
-                "events": [
-                  {
-                    "event_name": "business_partner",
-                    "timestamp": "2025-05-01T08:30:00Z",
-                    "format": "json",
-                    "payload": "{\"id\":\"BP10001\",\"name\":\"Acme Corporation\",\"type\":\"organization\",\"tax_id\":\"DE123456789\",\"status\":\"active\"}",
-                    "deduplication_id": "bp-create-20250501-083000-001"
-                  },
-                  {
-                    "event_name": "contract_account",
-                    "timestamp": "2025-05-01T08:35:00Z",
-                    "format": "json",
-                    "payload": "{\"id\":\"CA20001\",\"business_partner_id\":\"BP10001\",\"status\":\"active\",\"payment_method\":\"direct_debit\"}",
-                    "deduplication_id": "ca-update-20250501-083500-001"
-                  }
-                ]
-              }
-            }
-          }
-        },
-        "responses": {
-          "200": {
+          "422": {
             "$ref": "#/components/responses/ERPUpdatesResponse"
           },
-          "400": {
-            "$ref": "#/components/responses/BadRequest"
-          },
-          "401": {
-            "$ref": "#/components/responses/Unauthorized"
-          },
           "500": {
             "$ref": "#/components/responses/InternalServerError"
           }
@@ -1831,6 +1782,103 @@
         }
       }
     },
+    "/v2/integrations/{integrationId}/environment": {
+      "get": {
+        "operationId": "getIntegrationEnvironment",
+        "summary": "getIntegrationEnvironment",
+        "description": "Retrieve the environment configuration for an integration.\nSecret values are masked and replaced with \"****\" to prevent exposure.\n",
+        "tags": [
+          "integrations"
+        ],
+        "parameters": [
+          {
+            "name": "integrationId",
+            "in": "path",
+            "required": true,
+            "description": "The integration ID",
+            "schema": {
+              "type": "string",
+              "format": "uuid"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Successfully retrieved environment",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/IntegrationEnvironment"
+                }
+              }
+            }
+          },
+          "401": {
+            "$ref": "#/components/responses/Unauthorized"
+          },
+          "404": {
+            "description": "Integration not found"
+          },
+          "500": {
+            "$ref": "#/components/responses/InternalServerError"
+          }
+        }
+      },
+      "patch": {
+        "operationId": "updateIntegrationEnvironment",
+        "summary": "updateIntegrationEnvironment",
+        "description": "Update the environment configuration for an integration.\nSupports partial updates - only provided values are modified.\nSecret values can be updated by providing the actual value in the secrets field.\nTo keep existing secrets, omit them from the request.\nTo clear a value, set it to null.\n",
+        "tags": [
+          "integrations"
+        ],
+        "parameters": [
+          {
+            "name": "integrationId",
+            "in": "path",
+            "required": true,
+            "description": "The integration ID",
+            "schema": {
+              "type": "string",
+              "format": "uuid"
+            }
+          }
+        ],
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/UpdateIntegrationEnvironmentRequest"
+              }
+            }
+          }
+        },
+        "responses": {
+          "200": {
+            "description": "Environment updated successfully",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/IntegrationEnvironment"
+                }
+              }
+            }
+          },
+          "400": {
+            "$ref": "#/components/responses/BadRequest"
+          },
+          "401": {
+            "$ref": "#/components/responses/Unauthorized"
+          },
+          "404": {
+            "description": "Integration not found"
+          },
+          "500": {
+            "$ref": "#/components/responses/InternalServerError"
+          }
+        }
+      }
+    },
     "/v1/integrations/{integrationId}/app-mapping": {
       "put": {
         "operationId": "setIntegrationAppMapping",
@@ -1956,11 +2004,11 @@
         }
       }
     },
-    "/v1/integrations/{integrationId}/monitoring/inbound-events": {
+    "/v1/integrations/{integrationId}/monitoring/events": {
       "post": {
-        "operationId": "queryInboundMonitoringEvents",
-        "summary": "queryInboundMonitoringEvents",
-        "description": "Query inbound monitoring events for a specific integration.\nReturns detailed information about inbound sync events from ERP systems,\nincluding success rates, error breakdowns, and processing metrics.\n",
+        "operationId": "queryMonitoringEvents",
+        "summary": "queryMonitoringEvents",
+        "description": "Query ERP sync monitoring events for a specific integration.\nReturns detailed information about inbound/outbound sync events,\nincluding success rates, error breakdowns, and processing metrics.\n",
         "tags": [
           "monitoring",
           "integrations"
@@ -1982,14 +2030,14 @@
           "content": {
             "application/json": {
               "schema": {
-                "$ref": "#/components/schemas/QueryInboundMonitoringEventsRequest"
+                "$ref": "#/components/schemas/QueryMonitoringEventsRequest"
               }
             }
           }
         },
         "responses": {
           "200": {
-            "$ref": "#/components/responses/QueryInboundMonitoringEventsResponse"
+            "$ref": "#/components/responses/QueryMonitoringEventsResponse"
           },
           "400": {
             "$ref": "#/components/responses/BadRequest"
@@ -2010,7 +2058,7 @@
       "post": {
         "operationId": "getMonitoringStats",
         "summary": "getMonitoringStats",
-        "description": "Get aggregated statistics for both inbound and outbound monitoring events for a specific integration.\nReturns summary metrics for inbound (ERP sync) and outbound (webhook delivery) events,\nincluding success/error counts and optional breakdowns.\n",
+        "description": "Get aggregated statistics for ERP sync monitoring events for a specific integration.\nReturns summary metrics like total events, success/error counts,\nand breakdowns by use case, direction, and sync type.\n",
         "tags": [
           "monitoring",
           "integrations"
@@ -2056,56 +2104,6 @@
         }
       }
     },
-    "/v1/integrations/{integrationId}/monitoring/timeseries": {
-      "post": {
-        "operationId": "getMonitoringTimeSeries",
-        "summary": "getMonitoringTimeSeries",
-        "description": "Get time-series aggregated event counts for monitoring charts.\nReturns pre-bucketed counts at configurable intervals for both inbound and outbound events.\nMaximum of 200 buckets per request. Returns 400 if the time range and interval would exceed this limit.\n",
-        "tags": [
-          "monitoring",
-          "integrations"
-        ],
-        "parameters": [
-          {
-            "name": "integrationId",
-            "in": "path",
-            "required": true,
-            "description": "The integration ID",
-            "schema": {
-              "type": "string",
-              "format": "uuid"
-            }
-          }
-        ],
-        "requestBody": {
-          "required": true,
-          "content": {
-            "application/json": {
-              "schema": {
-                "$ref": "#/components/schemas/GetMonitoringTimeSeriesRequest"
-              }
-            }
-          }
-        },
-        "responses": {
-          "200": {
-            "$ref": "#/components/responses/GetMonitoringTimeSeriesResponse"
-          },
-          "400": {
-            "$ref": "#/components/responses/BadRequest"
-          },
-          "401": {
-            "$ref": "#/components/responses/Unauthorized"
-          },
-          "404": {
-            "$ref": "#/components/responses/NotFound"
-          },
-          "500": {
-            "$ref": "#/components/responses/InternalServerError"
-          }
-        }
-      }
-    },
     "/v1/integrations/{integrationId}/outbound-status": {
       "get": {
         "operationId": "getOutboundStatus",
@@ -2198,56 +2196,6 @@
           }
         }
       }
-    },
-    "/v1/integrations/{integrationId}/monitoring/outbound-events": {
-      "post": {
-        "operationId": "queryOutboundMonitoringEvents",
-        "summary": "queryOutboundMonitoringEvents",
-        "description": "Query outbound monitoring events for a specific integration.\nReturns detailed information about outbound event deliveries,\nfiltered by event_name (event_catalog_event) linked to the integration's outbound use cases.\n",
-        "tags": [
-          "monitoring",
-          "integrations"
-        ],
-        "parameters": [
-          {
-            "name": "integrationId",
-            "in": "path",
-            "required": true,
-            "description": "The integration ID",
-            "schema": {
-              "type": "string",
-              "format": "uuid"
-            }
-          }
-        ],
-        "requestBody": {
-          "required": true,
-          "content": {
-            "application/json": {
-              "schema": {
-                "$ref": "#/components/schemas/QueryOutboundMonitoringEventsRequest"
-              }
-            }
-          }
-        },
-        "responses": {
-          "200": {
-            "$ref": "#/components/responses/QueryOutboundMonitoringEventsResponse"
-          },
-          "400": {
-            "$ref": "#/components/responses/BadRequest"
-          },
-          "401": {
-            "$ref": "#/components/responses/Unauthorized"
-          },
-          "404": {
-            "$ref": "#/components/responses/NotFound"
-          },
-          "500": {
-            "$ref": "#/components/responses/InternalServerError"
-          }
-        }
-      }
     }
   },
   "components": {
@@ -2359,108 +2307,32 @@
           }
         }
       },
-      "ErpEventV3": {
+      "TriggerErpActionRequest": {
         "type": "object",
         "required": [
-          "event_name",
-          "timestamp",
-          "format",
-          "payload"
+          "execution_id",
+          "org_id",
+          "webhook_id",
+          "flow_id",
+          "created_at",
+          "action_id",
+          "flow_action_id",
+          "flow_name",
+          "activity_id",
+          "entity_id"
         ],
         "properties": {
-          "event_name": {
+          "execution_id": {
             "type": "string",
-            "description": "Name of the event (e.g., business_partner, contract_account). Corresponds to the \"Event Name\" from the integration UI. Replaces object_type from V2."
+            "description": "Unique identifier of the current automation execution"
           },
-          "timestamp": {
+          "org_id": {
             "type": "string",
-            "format": "date-time",
-            "description": "Timestamp when the event occurred"
+            "description": "Identifier of the organization where the automation is executed"
           },
-          "format": {
+          "webhook_id": {
             "type": "string",
-            "enum": [
-              "json",
-              "xml"
-            ],
-            "default": "json",
-            "description": "Format of the payload data"
-          },
-          "payload": {
-            "oneOf": [
-              {
-                "type": "string",
-                "description": "The serialized object data payload (JSON, XML, etc.) as a string"
-              },
-              {
-                "type": "object",
-                "description": "Direct JSON object (will be automatically serialized)",
-                "additionalProperties": true
-              }
-            ],
-            "description": "The object data payload - can be either a serialized string or a direct JSON object"
-          },
-          "deduplication_id": {
-            "type": "string",
-            "pattern": "^[a-zA-Z0-9_-]+$",
-            "minLength": 1,
-            "maxLength": 255,
-            "description": "Optional unique identifier for idempotency - prevents duplicate processing of the same event within 24 hours in context of the same integration. Must contain only alphanumeric characters, hyphens, and underscores.\n",
-            "example": "evt-2025-05-01-12345-bp"
-          }
-        }
-      },
-      "ErpUpdatesEventsV3Request": {
-        "type": "object",
-        "required": [
-          "integration_id",
-          "events"
-        ],
-        "properties": {
-          "integration_id": {
-            "type": "string",
-            "format": "uuid",
-            "description": "UUID that identifies the integration configuration to use"
-          },
-          "correlation_id": {
-            "type": "string",
-            "description": "Optional ID that identifies the specific request for debugging purposes"
-          },
-          "events": {
-            "type": "array",
-            "description": "List of ERP events to process",
-            "items": {
-              "$ref": "#/components/schemas/ErpEventV3"
-            }
-          }
-        }
-      },
-      "TriggerErpActionRequest": {
-        "type": "object",
-        "required": [
-          "execution_id",
-          "org_id",
-          "webhook_id",
-          "flow_id",
-          "created_at",
-          "action_id",
-          "flow_action_id",
-          "flow_name",
-          "activity_id",
-          "entity_id"
-        ],
-        "properties": {
-          "execution_id": {
-            "type": "string",
-            "description": "Unique identifier of the current automation execution"
-          },
-          "org_id": {
-            "type": "string",
-            "description": "Identifier of the organization where the automation is executed"
-          },
-          "webhook_id": {
-            "type": "string",
-            "description": "Identifier of the self-service webhook configuration"
+            "description": "Identifier of the self-service webhook configuration"
           },
           "flow_id": {
             "type": "string",
@@ -2553,13 +2425,6 @@
             "type": "string",
             "description": "Optional description of the integration"
           },
-          "access_token_ids": {
-            "type": "array",
-            "description": "List of access token IDs associated with this integration",
-            "items": {
-              "type": "string"
-            }
-          },
           "created_at": {
             "type": "string",
             "format": "date-time",
@@ -2588,13 +2453,6 @@
             "type": "string",
             "maxLength": 1000,
             "description": "Optional description of the integration"
-          },
-          "access_token_ids": {
-            "type": "array",
-            "description": "List of access token IDs to associate with this integration",
-            "items": {
-              "type": "string"
-            }
           }
         }
       },
@@ -2611,13 +2469,6 @@
             "type": "string",
             "maxLength": 1000,
             "description": "Optional description of the integration"
-          },
-          "access_token_ids": {
-            "type": "array",
-            "description": "List of access token IDs to associate with this integration",
-            "items": {
-              "type": "string"
-            }
           }
         }
       },
@@ -2677,6 +2528,69 @@
           }
         }
       },
+      "IntegrationEnvironment": {
+        "type": "object",
+        "description": "Environment configuration for an integration with masked secrets",
+        "required": [
+          "integrationId",
+          "values"
+        ],
+        "properties": {
+          "integrationId": {
+            "type": "string",
+            "format": "uuid",
+            "description": "Parent integration ID"
+          },
+          "values": {
+            "type": "object",
+            "additionalProperties": {
+              "type": "string"
+            },
+            "description": "Environment values as key-value pairs.\nSecret values are masked as \"****\" in responses.\n"
+          },
+          "secret_keys": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            },
+            "description": "List of keys that contain secret values (masked in values field)"
+          },
+          "created_at": {
+            "type": "string",
+            "format": "date-time",
+            "nullable": true,
+            "description": "ISO-8601 timestamp when the environment was created"
+          },
+          "updated_at": {
+            "type": "string",
+            "format": "date-time",
+            "nullable": true,
+            "description": "ISO-8601 timestamp when the environment was last updated"
+          }
+        }
+      },
+      "UpdateIntegrationEnvironmentRequest": {
+        "type": "object",
+        "description": "Request to update environment configuration.\nSupports partial updates - only provided values are modified.\n",
+        "properties": {
+          "values": {
+            "type": "object",
+            "additionalProperties": {
+              "type": "string",
+              "nullable": true
+            },
+            "description": "Plain text environment values to update.\nSet a value to null to clear it.\n"
+          },
+          "secrets": {
+            "type": "object",
+            "additionalProperties": {
+              "type": "string",
+              "nullable": true
+            },
+            "description": "Secret environment values to update.\nThese are stored securely and masked in GET responses.\nSet a value to null to clear it.\nOmit a secret to keep its existing value.\n"
+          }
+        }
+      },
       "UseCaseBase": {
         "type": "object",
         "required": [
@@ -3253,7 +3167,7 @@
           "attributes": {
             "type": "object",
             "additionalProperties": true,
-            "description": "Meter reading attributes. Required: external_id, timestamp, source, value. `source` must be one of: ECP, ERP, 360, journey-submission. `reason` (optional) must be one of: regular, irregular, last, first, meter_change, contract_change, meter_adjustment (or empty/null)."
+            "description": "Meter reading attributes (external_id, timestamp, source, value, etc.)"
           }
         }
       },
@@ -3652,21 +3566,6 @@
             ],
             "description": "Controls whether this entity mapping should be processed. Can be a boolean or a JSONata expression (string) that evaluates to a boolean."
           },
-          "mode": {
-            "type": "string",
-            "enum": [
-              "upsert",
-              "delete",
-              "purge",
-              "upsert-prune-scope-purge",
-              "upsert-prune-scope-delete"
-            ],
-            "default": "upsert",
-            "description": "Operation mode for entity mapping:\n- 'upsert': Create or update the entity (default)\n- 'delete': Soft delete the entity (marks as deleted)\n- 'purge': Hard delete the entity (permanent removal)\n- 'upsert-prune-scope-purge': Upsert entities from array, then purge entities in scope that weren't upserted\n- 'upsert-prune-scope-delete': Upsert entities from array, then soft delete entities in scope that weren't upserted\n"
-          },
-          "scope": {
-            "$ref": "#/components/schemas/PruneScopeConfig"
-          },
           "fields": {
             "type": "array",
             "description": "Field mapping definitions",
@@ -3676,41 +3575,6 @@
           }
         }
       },
-      "PruneScopeConfig": {
-        "type": "object",
-        "description": "Scope configuration for upsert-prune-scope modes.\nDefines how to find entities that should be pruned if not in the upsert payload.\nThe scope is resolved against the original event payload (not individual array items).\n",
-        "required": [
-          "scope_mode"
-        ],
-        "properties": {
-          "scope_mode": {
-            "type": "string",
-            "enum": [
-              "relations",
-              "query"
-            ],
-            "description": "Scope mode for finding entities to prune:\n- 'relations': Find scope by looking at all entities related to a specific entity (both direct and reverse relations)\n- 'query': Find scope entities directly via query parameters\n"
-          },
-          "schema": {
-            "type": "string",
-            "description": "For 'relations' mode: The schema of the entity to find (e.g., 'billing_account').\nNot used for 'query' mode.\n"
-          },
-          "unique_ids": {
-            "type": "array",
-            "description": "For 'relations' mode: How to identify the scope entity from the payload.\nNot used for 'query' mode.\n",
-            "items": {
-              "$ref": "#/components/schemas/RelationUniqueIdField"
-            }
-          },
-          "query": {
-            "type": "array",
-            "description": "For 'query' mode: Direct query parameters to find scope entities.\nNot used for 'relations' or 'reverse-relations' modes.\n",
-            "items": {
-              "$ref": "#/components/schemas/RelationUniqueIdField"
-            }
-          }
-        }
-      },
       "IntegrationMeterReading": {
         "type": "object",
         "required": [
@@ -4015,13 +3879,6 @@
             "type": "string",
             "description": "Optional description of the integration"
           },
-          "access_token_ids": {
-            "type": "array",
-            "description": "List of access token IDs associated with this integration",
-            "items": {
-              "type": "string"
-            }
-          },
           "use_cases": {
             "type": "array",
             "description": "All use cases belonging to this integration",
@@ -4059,13 +3916,6 @@
             "maxLength": 1000,
             "description": "Optional description of the integration"
           },
-          "access_token_ids": {
-            "type": "array",
-            "description": "List of access token IDs to associate with this integration",
-            "items": {
-              "type": "string"
-            }
-          },
           "use_cases": {
             "type": "array",
             "description": "Full list of use cases (declarative). This replaces ALL existing use cases.\n- Use cases with an `id` field matching an existing use case will be updated\n- Use cases without an `id` or with a non-matching `id` will be created\n- Existing use cases not in this list will be deleted\n",
@@ -4213,10 +4063,6 @@
             "type": "string",
             "description": "Filter by object type"
           },
-          "event_name": {
-            "type": "string",
-            "description": "Filter by event name (alias for object_type)"
-          },
           "limit": {
             "type": "integer",
             "description": "Maximum number of results to return",
@@ -4244,7 +4090,7 @@
           }
         }
       },
-      "QueryInboundMonitoringEventsRequest": {
+      "QueryMonitoringEventsRequest": {
         "type": "object",
         "properties": {
           "use_case_id": {
@@ -4252,6 +4098,14 @@
             "format": "uuid",
             "description": "Filter by use case ID"
           },
+          "direction": {
+            "type": "string",
+            "enum": [
+              "inbound",
+              "outbound"
+            ],
+            "description": "Filter by sync direction"
+          },
           "event_type": {
             "type": "string",
             "enum": [
@@ -4267,8 +4121,7 @@
             "enum": [
               "entity",
               "meter_reading",
-              "webhook",
-              "api_deprecation"
+              "webhook"
             ],
             "description": "Filter by sync type"
           },
@@ -4277,8 +4130,7 @@
             "enum": [
               "success",
               "error",
-              "skipped",
-              "warning"
+              "skipped"
             ],
             "description": "Filter by processing status"
           },
@@ -4289,7 +4141,8 @@
               "configuration",
               "downstream_api",
               "timeout",
-              "system"
+              "system",
+              "webhook_delivery"
             ],
             "description": "Filter by error category (only applicable when status=error)"
           },
@@ -4301,10 +4154,6 @@
             "type": "string",
             "description": "Filter by object type (e.g., 'contract', 'meter')"
           },
-          "event_name": {
-            "type": "string",
-            "description": "Filter by event name (alias for object_type)"
-          },
           "event_id": {
             "type": "string",
             "description": "Filter by event ID to find a specific event"
@@ -4348,10 +4197,13 @@
       },
       "QueryAccessLogsRequest": {
         "type": "object",
+        "required": [
+          "token_id"
+        ],
         "properties": {
           "token_id": {
             "type": "string",
-            "description": "Filter by a specific access token ID (e.g., 'api_5ZugdRXasLfWBypHi93Fk').\nMust be one of the access_token_ids linked to the integration.\nIf omitted, returns logs for all access tokens linked to the integration.\n",
+            "description": "Filter by access token ID (e.g., 'api_5ZugdRXasLfWBypHi93Fk')",
             "example": "api_5ZugdRXasLfWBypHi93Fk"
           },
           "service": {
@@ -4480,6 +4332,19 @@
       "GetMonitoringStatsRequest": {
         "type": "object",
         "properties": {
+          "use_case_id": {
+            "type": "string",
+            "format": "uuid",
+            "description": "Filter by use case ID"
+          },
+          "direction": {
+            "type": "string",
+            "enum": [
+              "inbound",
+              "outbound"
+            ],
+            "description": "Filter by sync direction"
+          },
           "from_date": {
             "type": "string",
             "format": "date-time",
@@ -4492,392 +4357,35 @@
             "description": "End date for statistics period (inclusive)",
             "example": "2025-01-31T23:59:59Z"
           },
-          "inbound_group_by": {
+          "group_by": {
             "type": "array",
             "items": {
               "type": "string",
               "enum": [
+                "direction",
                 "use_case_id",
                 "sync_type",
                 "status",
                 "error_category",
                 "object_type",
-                "event_name",
                 "date"
               ]
             },
-            "description": "Fields to group inbound statistics by",
+            "description": "Fields to group statistics by",
             "example": [
-              "use_case_id",
+              "direction",
               "status"
             ]
-          },
-          "outbound_group_by": {
-            "type": "array",
-            "items": {
-              "type": "string",
-              "enum": [
-                "event_name",
-                "status",
-                "webhook_config_id",
-                "date"
-              ]
-            },
-            "description": "Fields to group outbound statistics by",
-            "example": [
-              "event_name",
-              "status"
-            ]
-          }
-        }
-      },
-      "GetMonitoringTimeSeriesRequest": {
-        "type": "object",
-        "required": [
-          "from_date",
-          "interval"
-        ],
-        "properties": {
-          "from_date": {
-            "type": "string",
-            "format": "date-time",
-            "description": "Start date for the time series (inclusive)",
-            "example": "2025-01-01T00:00:00Z"
-          },
-          "to_date": {
-            "type": "string",
-            "format": "date-time",
-            "description": "End date for the time series (inclusive). Defaults to current time if not specified.",
-            "example": "2025-01-31T23:59:59Z"
-          },
-          "interval": {
-            "type": "string",
-            "enum": [
-              "5m",
-              "10m",
-              "30m",
-              "1h",
-              "3h",
-              "1d"
-            ],
-            "description": "The time bucket interval for aggregation",
-            "example": "1h"
-          },
-          "direction": {
-            "type": "string",
-            "enum": [
-              "inbound",
-              "outbound",
-              "both"
-            ],
-            "default": "both",
-            "description": "Filter by event direction. Defaults to both.",
-            "example": "both"
-          }
-        }
-      },
-      "TimeSeriesBucket": {
-        "type": "object",
-        "required": [
-          "timestamp"
-        ],
-        "properties": {
-          "timestamp": {
-            "type": "string",
-            "format": "date-time",
-            "description": "The start timestamp of the bucket"
-          },
-          "inbound": {
-            "type": "object",
-            "nullable": true,
-            "description": "Inbound event counts for this bucket. Null when direction is outbound.",
-            "properties": {
-              "success_count": {
-                "type": "integer"
-              },
-              "error_count": {
-                "type": "integer"
-              },
-              "warning_count": {
-                "type": "integer"
-              },
-              "skipped_count": {
-                "type": "integer"
-              },
-              "total_count": {
-                "type": "integer"
-              }
-            }
-          },
-          "outbound": {
-            "type": "object",
-            "nullable": true,
-            "description": "Outbound event counts for this bucket. Null when direction is inbound.",
-            "properties": {
-              "success_count": {
-                "type": "integer"
-              },
-              "error_count": {
-                "type": "integer"
-              },
-              "pending_count": {
-                "type": "integer"
-              },
-              "total_count": {
-                "type": "integer"
-              }
-            }
-          }
-        }
-      },
-      "QueryOutboundMonitoringEventsRequest": {
-        "type": "object",
-        "properties": {
-          "event_name": {
-            "type": "string",
-            "description": "Filter by event name (event_catalog_event). If not specified, returns events for all linked event names in the integration's outbound use cases.",
-            "example": "automation_flow_target"
-          },
-          "status": {
-            "type": "string",
-            "enum": [
-              "succeeded",
-              "failed",
-              "pending"
-            ],
-            "description": "Filter by delivery status"
-          },
-          "webhook_config_id": {
-            "type": "string",
-            "description": "Filter by webhook configuration ID"
-          },
-          "from_date": {
-            "type": "string",
-            "format": "date-time",
-            "description": "Filter events from this date (inclusive)",
-            "example": "2025-01-01T00:00:00Z"
-          },
-          "to_date": {
-            "type": "string",
-            "format": "date-time",
-            "description": "Filter events until this date (inclusive)",
-            "example": "2025-01-31T23:59:59Z"
-          },
-          "limit": {
-            "type": "integer",
-            "description": "Maximum number of results to return",
-            "example": 50,
-            "default": 50,
-            "minimum": 1,
-            "maximum": 100
-          },
-          "cursor": {
-            "type": "object",
-            "description": "Cursor for pagination",
-            "properties": {
-              "created_at": {
-                "type": "string",
-                "format": "date-time",
-                "description": "Timestamp from the last event in the previous page"
-              },
-              "event_id": {
-                "type": "string",
-                "description": "Event ID from the last event in the previous page"
-              }
-            }
-          }
-        }
-      },
-      "OutboundMonitoringEvent": {
-        "type": "object",
-        "required": [
-          "org_id",
-          "event_id",
-          "event_name",
-          "status",
-          "created_at"
-        ],
-        "properties": {
-          "org_id": {
-            "type": "string",
-            "description": "Organization ID"
-          },
-          "event_id": {
-            "type": "string",
-            "description": "Unique event identifier"
-          },
-          "event_name": {
-            "type": "string",
-            "description": "Event name (event_catalog_event)"
-          },
-          "status": {
-            "type": "string",
-            "enum": [
-              "succeeded",
-              "failed",
-              "pending"
-            ],
-            "description": "Delivery status"
-          },
-          "url": {
-            "type": "string",
-            "description": "Target URL"
-          },
-          "http_method": {
-            "type": "string",
-            "description": "HTTP method used (e.g., POST)"
-          },
-          "http_response": {
-            "type": "object",
-            "description": "HTTP response details (status_code, message, headers)",
-            "additionalProperties": true
-          },
-          "webhook_config_id": {
-            "type": "string",
-            "description": "Webhook configuration ID"
-          },
-          "metadata": {
-            "type": "object",
-            "description": "Additional metadata (webhook_id, organization details, correlation_id, etc.)",
-            "additionalProperties": true
-          },
-          "execution_context": {
-            "type": "object",
-            "description": "Execution context (execution_arn, state_machine_arn, etc.)",
-            "additionalProperties": true
-          },
-          "payload": {
-            "type": "object",
-            "description": "Payload that was sent",
-            "additionalProperties": true
-          },
-          "created_at": {
-            "type": "string",
-            "format": "date-time",
-            "description": "When the event was created"
-          },
-          "updated_at": {
-            "type": "string",
-            "format": "date-time",
-            "description": "When the event was last updated"
-          }
-        }
-      },
-      "MonitoringStats": {
-        "type": "object",
-        "required": [
-          "inbound",
-          "outbound"
-        ],
-        "properties": {
-          "inbound": {
-            "type": "object",
-            "description": "Statistics for inbound (ERP sync) events",
-            "required": [
-              "total_events",
-              "success_count",
-              "error_count",
-              "skipped_count"
-            ],
-            "properties": {
-              "total_events": {
-                "type": "integer",
-                "description": "Total number of inbound events in the period"
-              },
-              "total_correlations": {
-                "type": "integer",
-                "description": "Total number of unique correlation IDs"
-              },
-              "success_count": {
-                "type": "integer",
-                "description": "Number of successful events"
-              },
-              "error_count": {
-                "type": "integer",
-                "description": "Number of failed events"
-              },
-              "skipped_count": {
-                "type": "integer",
-                "description": "Number of skipped events"
-              },
-              "warning_count": {
-                "type": "integer",
-                "description": "Number of warning events"
-              },
-              "success_rate": {
-                "type": "number",
-                "format": "float",
-                "description": "Success rate as percentage (0-100)"
-              },
-              "last_error_at": {
-                "type": "string",
-                "format": "date-time",
-                "nullable": true,
-                "description": "Timestamp of the most recent error"
-              },
-              "breakdown": {
-                "type": "array",
-                "description": "Statistics breakdown by requested inbound_group_by fields",
-                "items": {
-                  "type": "object",
-                  "additionalProperties": true
-                }
-              }
-            }
-          },
-          "outbound": {
-            "type": "object",
-            "description": "Statistics for outbound (webhook delivery) events",
-            "required": [
-              "total_events",
-              "success_count",
-              "error_count"
-            ],
-            "properties": {
-              "total_events": {
-                "type": "integer",
-                "description": "Total number of outbound events in the period"
-              },
-              "success_count": {
-                "type": "integer",
-                "description": "Number of successful deliveries"
-              },
-              "error_count": {
-                "type": "integer",
-                "description": "Number of failed deliveries"
-              },
-              "pending_count": {
-                "type": "integer",
-                "description": "Number of pending deliveries"
-              },
-              "success_rate": {
-                "type": "number",
-                "format": "float",
-                "description": "Success rate as percentage (0-100)"
-              },
-              "last_error_at": {
-                "type": "string",
-                "format": "date-time",
-                "nullable": true,
-                "description": "Timestamp of the most recent error"
-              },
-              "breakdown": {
-                "type": "array",
-                "description": "Statistics breakdown by requested outbound_group_by fields",
-                "items": {
-                  "type": "object",
-                  "additionalProperties": true
-                }
-              }
-            }
           }
         }
       },
-      "InboundMonitoringEvent": {
+      "MonitoringEvent": {
         "type": "object",
         "required": [
           "org_id",
           "event_id",
+          "direction",
+          "event_type",
           "object_type",
           "sync_type",
           "status",
@@ -4908,6 +4416,14 @@
             "nullable": true,
             "description": "Use case ID"
           },
+          "direction": {
+            "type": "string",
+            "enum": [
+              "inbound",
+              "outbound"
+            ],
+            "description": "Sync direction"
+          },
           "event_type": {
             "type": "string",
             "enum": [
@@ -4916,7 +4432,7 @@
               "DELETE",
               "TRIGGER"
             ],
-            "description": "Type of event (optional for V3 events)"
+            "description": "Type of event"
           },
           "object_type": {
             "type": "string",
@@ -4927,8 +4443,7 @@
             "enum": [
               "entity",
               "meter_reading",
-              "webhook",
-              "api_deprecation"
+              "webhook"
             ],
             "description": "Type of sync operation"
           },
@@ -4937,8 +4452,7 @@
             "enum": [
               "success",
               "error",
-              "skipped",
-              "warning"
+              "skipped"
             ],
             "description": "Processing status"
           },
@@ -4960,7 +4474,8 @@
               "configuration",
               "downstream_api",
               "timeout",
-              "system"
+              "system",
+              "webhook_delivery"
             ],
             "description": "Error category (when status=error)"
           },
@@ -4969,6 +4484,16 @@
             "nullable": true,
             "description": "Processing duration in milliseconds"
           },
+          "target_url": {
+            "type": "string",
+            "nullable": true,
+            "description": "Target URL for outbound requests"
+          },
+          "http_status_code": {
+            "type": "integer",
+            "nullable": true,
+            "description": "HTTP status code from target (outbound only)"
+          },
           "received_at": {
             "type": "string",
             "format": "date-time",
@@ -4980,6 +4505,57 @@
             "description": "When processing completed"
           }
         }
+      },
+      "MonitoringStats": {
+        "type": "object",
+        "required": [
+          "total_events",
+          "total_correlations",
+          "success_count",
+          "error_count",
+          "skipped_count"
+        ],
+        "properties": {
+          "total_events": {
+            "type": "integer",
+            "description": "Total number of events in the period"
+          },
+          "total_correlations": {
+            "type": "integer",
+            "description": "Total number of unique correlation IDs (a correlation_id groups multiple event_ids)"
+          },
+          "success_count": {
+            "type": "integer",
+            "description": "Number of successful events"
+          },
+          "error_count": {
+            "type": "integer",
+            "description": "Number of failed events"
+          },
+          "skipped_count": {
+            "type": "integer",
+            "description": "Number of skipped events"
+          },
+          "success_rate": {
+            "type": "number",
+            "format": "float",
+            "description": "Success rate as percentage (0-100)"
+          },
+          "last_error_at": {
+            "type": "string",
+            "format": "date-time",
+            "nullable": true,
+            "description": "Timestamp of the most recent error"
+          },
+          "breakdown": {
+            "type": "array",
+            "description": "Statistics breakdown by requested group_by fields",
+            "items": {
+              "type": "object",
+              "additionalProperties": true
+            }
+          }
+        }
       }
     },
     "responses": {
@@ -5023,8 +4599,8 @@
           }
         }
       },
-      "QueryInboundMonitoringEventsResponse": {
-        "description": "Inbound monitoring events queried successfully",
+      "QueryMonitoringEventsResponse": {
+        "description": "Monitoring events queried successfully",
         "content": {
           "application/json": {
             "schema": {
@@ -5033,9 +4609,9 @@
                 "data": {
                   "type": "array",
                   "items": {
-                    "$ref": "#/components/schemas/InboundMonitoringEvent"
+                    "$ref": "#/components/schemas/MonitoringEvent"
                   },
-                  "description": "List of inbound monitoring events"
+                  "description": "List of monitoring events"
                 },
                 "next_cursor": {
                   "type": "object",
@@ -5070,53 +4646,6 @@
           }
         }
       },
-      "GetMonitoringTimeSeriesResponse": {
-        "description": "Time-series aggregated event counts retrieved successfully",
-        "content": {
-          "application/json": {
-            "schema": {
-              "type": "object",
-              "required": [
-                "interval",
-                "from_date",
-                "to_date",
-                "buckets"
-              ],
-              "properties": {
-                "interval": {
-                  "type": "string",
-                  "enum": [
-                    "5m",
-                    "10m",
-                    "30m",
-                    "1h",
-                    "3h",
-                    "1d"
-                  ],
-                  "description": "The time bucket interval used for aggregation"
-                },
-                "from_date": {
-                  "type": "string",
-                  "format": "date-time",
-                  "description": "Start date of the time series"
-                },
-                "to_date": {
-                  "type": "string",
-                  "format": "date-time",
-                  "description": "End date of the time series"
-                },
-                "buckets": {
-                  "type": "array",
-                  "items": {
-                    "$ref": "#/components/schemas/TimeSeriesBucket"
-                  },
-                  "description": "List of time-series buckets with event counts"
-                }
-              }
-            }
-          }
-        }
-      },
       "QueryAccessLogsResponse": {
         "description": "Access logs queried successfully",
         "content": {
@@ -5154,43 +4683,6 @@
           }
         }
       },
-      "QueryOutboundMonitoringEventsResponse": {
-        "description": "Outbound monitoring events queried successfully",
-        "content": {
-          "application/json": {
-            "schema": {
-              "type": "object",
-              "properties": {
-                "data": {
-                  "type": "array",
-                  "items": {
-                    "$ref": "#/components/schemas/OutboundMonitoringEvent"
-                  },
-                  "description": "List of outbound monitoring events"
-                },
-                "next_cursor": {
-                  "type": "object",
-                  "nullable": true,
-                  "description": "Cursor to fetch the next page. Null if no more results.",
-                  "properties": {
-                    "created_at": {
-                      "type": "string",
-                      "format": "date-time"
-                    },
-                    "event_id": {
-                      "type": "string"
-                    }
-                  }
-                },
-                "has_more": {
-                  "type": "boolean",
-                  "description": "Indicates if more results are available"
-                }
-              }
-            }
-          }
-        }
-      },
       "ReplayEventsResponse": {
         "description": "Events replay initiated",
         "content": {
@@ -5239,10 +4731,9 @@
                         "enum": [
                           "success",
                           "error",
-                          "skipped",
-                          "ignored"
+                          "skipped"
                         ],
-                        "description": "Processing status for the event (skipped indicates duplicate deduplication_id, ignored indicates unconfigured event)"
+                        "description": "Processing status for the event (skipped indicates duplicate deduplication_id)"
                       },
                       "message": {
                         "type": "string"