@epilot/sdk 2.20.78 → 2.20.79

package/docs/integration-toolkit.md

@@ -80,11 +80,7 @@ const { data } = await integrationToolkitClient.acknowledgeTracking(...)
 - [`commitTypes`](#committypes)
 
 **monitoring**
-- [`queryInboundMonitoringEvents`](#queryinboundmonitoringevents)
-- [`getMonitoringStats`](#getmonitoringstats)
-- [`getMonitoringTimeSeries`](#getmonitoringtimeseries)
 - [`queryAccessLogs`](#queryaccesslogs)
-- [`queryOutboundMonitoringEvents`](#queryoutboundmonitoringevents)
 - [`queryMonitoringEventsV2`](#querymonitoringeventsv2)
 - [`getMonitoringStatsV2`](#getmonitoringstatsv2)
 - [`getMonitoringTimeSeriesV2`](#getmonitoringtimeseriesv2)
@@ -142,6 +138,7 @@ const { data } = await integrationToolkitClient.acknowledgeTracking(...)
 - [`ErpEventV3`](#erpeventv3)
 - [`ErpUpdatesEventsV3Request`](#erpupdateseventsv3request)
 - [`ErpUpdateProcessedEntity`](#erpupdateprocessedentity)
+- [`CorrelationCloseResult`](#correlationcloseresult)
 - [`ErpUpdateProcessingError`](#erpupdateprocessingerror)
 - [`ErpUpdateEventStatus`](#erpupdateeventstatus)
 - [`CorrelationUseCaseCounts`](#correlationusecasecounts)
@@ -445,6 +442,11 @@ const { data } = await client.processErpUpdatesEventsV3(
 ```json
 {
   "correlation_id": "string",
+  "correlation_close": {
+    "outcome": "applied",
+    "reasons": ["retry_requested"],
+    "message": "string"
+  },
   "results": [
     {
       "event_id": "string",
@@ -486,6 +488,8 @@ const { data } = await client.queryErpUpdateEvents({
   "integration_id": "string",
   "closed": true,
   "closed_at": "1970-01-01T00:00:00.000Z",
+  "complete": true,
+  "completed_at": "1970-01-01T00:00:00.000Z",
   "events_received": 0,
   "events_done": 0,
   "late_events": 0,
@@ -509,15 +513,19 @@ const { data } = await client.queryErpUpdateEvents({
       }
     }
   ],
+  "entities_omitted": 0,
   "errors": [
     {
       "code": "string",
       "message": "string",
       "event_id": "string",
-      "occurred_at": "1970-01-01T00:00:00.000Z"
+      "occurred_at": "1970-01-01T00:00:00.000Z",
+      "after_completion": true
     }
   ],
-  "completion": "requirements_met"
+  "errors_total": 0,
+  "completion": "requirements_met",
+  "undecided_entity_requirements": ["contract[billing_account_number=4711]"]
 }
 ```
 
@@ -565,14 +573,17 @@ const { data } = await client.getErpUpdateEvent({
       }
     }
   ],
+  "entities_omitted": 0,
   "errors": [
     {
       "code": "string",
       "message": "string",
       "event_id": "string",
-      "occurred_at": "1970-01-01T00:00:00.000Z"
+      "occurred_at": "1970-01-01T00:00:00.000Z",
+      "after_completion": true
     }
-  ]
+  ],
+  "errors_total": 0
 }
 ```
 
@@ -607,6 +618,8 @@ const { data } = await client.listErpUpdateCorrelations({
       "integration_id": "string",
       "closed": true,
       "closed_at": "1970-01-01T00:00:00.000Z",
+      "complete": true,
+      "completed_at": "1970-01-01T00:00:00.000Z",
       "events_received": 0,
       "events_done": 0,
       "late_events": 0,
@@ -630,14 +643,17 @@ const { data } = await client.listErpUpdateCorrelations({
           }
         }
       ],
+      "entities_omitted": 0,
       "errors": [
         {
           "code": "string",
           "message": "string",
           "event_id": "string",
-          "occurred_at": "1970-01-01T00:00:00.000Z"
+          "occurred_at": "1970-01-01T00:00:00.000Z",
+          "after_completion": true
         }
-      ]
+      ],
+      "errors_total": 0
     }
   ],
   "next_cursor": "string",
@@ -2712,189 +2728,6 @@ const { data } = await client.deleteIntegrationAppMapping(
 
 ---
 
-### `queryInboundMonitoringEvents`
-
-Query inbound monitoring events for a specific integration.
-Returns detailed information about inbound sync events from ERP systems,
-including success rates, error breakdowns, and processing metrics.
-
-`POST /v1/integrations/{integrationId}/monitoring/inbound-events`
-
-```ts
-const { data } = await client.queryInboundMonitoringEvents(
-  {
-    integrationId: 'example',
-  },
-  {
-    use_case_id: '3fa85f64-5717-4562-b3fc-2c963f66afa6',
-    event_type: 'CREATE',
-    sync_type: 'entity',
-    status: 'success',
-    error_category: 'validation',
-    correlation_id: 'string',
-    object_type: 'string',
-    event_name: 'string',
-    event_id: 'string',
-    from_date: '2025-01-01T00:00:00Z',
-    to_date: '2025-01-31T23:59:59Z',
-    limit: 50,
-    cursor: {
-      completed_at: '1970-01-01T00:00:00.000Z',
-      event_id: 'string'
-    }
-  },
-)
-```
-
-<details>
-<summary>Response</summary>
-
-```json
-{
-  "data": [
-    {
-      "org_id": "string",
-      "event_id": "string",
-      "correlation_id": "string",
-      "integration_id": "string",
-      "use_case_id": "string",
-      "event_type": "CREATE",
-      "object_type": "string",
-      "sync_type": "entity",
-      "status": "success",
-      "error_code": "string",
-      "error_message": "string",
-      "error_category": "validation",
-      "processing_duration_ms": 0,
-      "received_at": "1970-01-01T00:00:00.000Z",
-      "completed_at": "1970-01-01T00:00:00.000Z"
-    }
-  ],
-  "next_cursor": {
-    "completed_at": "1970-01-01T00:00:00.000Z",
-    "event_id": "string"
-  },
-  "has_more": true
-}
-```
-
-</details>
-
----
-
-### `getMonitoringStats`
-
-Get aggregated statistics for both inbound and outbound monitoring events for a specific integration.
-Returns summary metrics for inbound (ERP sync) and outbound (webhook delivery) events,
-including s
-
-`POST /v1/integrations/{integrationId}/monitoring/stats`
-
-```ts
-const { data } = await client.getMonitoringStats(
-  {
-    integrationId: 'example',
-  },
-  {
-    from_date: '2025-01-01T00:00:00Z',
-    to_date: '2025-01-31T23:59:59Z',
-    inbound_group_by: ['use_case_id', 'status'],
-    outbound_group_by: ['event_name', 'status']
-  },
-)
-```
-
-<details>
-<summary>Response</summary>
-
-```json
-{
-  "inbound": {
-    "total_events": 0,
-    "total_correlations": 0,
-    "success_count": 0,
-    "error_count": 0,
-    "skipped_count": 0,
-    "warning_count": 0,
-    "success_rate": 0,
-    "last_error_at": "1970-01-01T00:00:00.000Z",
-    "breakdown": [
-      {}
-    ]
-  },
-  "outbound": {
-    "total_events": 0,
-    "success_count": 0,
-    "error_count": 0,
-    "pending_count": 0,
-    "success_rate": 0,
-    "last_error_at": "1970-01-01T00:00:00.000Z",
-    "breakdown": [
-      {}
-    ]
-  }
-}
-```
-
-</details>
-
----
-
-### `getMonitoringTimeSeries`
-
-Get time-series aggregated event counts for monitoring charts.
-Returns pre-bucketed counts at configurable intervals for both inbound and outbound events.
-Maximum of 200 buckets per request. Returns 4
-
-`POST /v1/integrations/{integrationId}/monitoring/timeseries`
-
-```ts
-const { data } = await client.getMonitoringTimeSeries(
-  {
-    integrationId: 'example',
-  },
-  {
-    from_date: '2025-01-01T00:00:00Z',
-    to_date: '2025-01-31T23:59:59Z',
-    interval: '1h',
-    direction: 'both'
-  },
-)
-```
-
-<details>
-<summary>Response</summary>
-
-```json
-{
-  "interval": "5m",
-  "from_date": "1970-01-01T00:00:00.000Z",
-  "to_date": "1970-01-01T00:00:00.000Z",
-  "buckets": [
-    {
-      "timestamp": "1970-01-01T00:00:00.000Z",
-      "inbound": {
-        "success_count": 0,
-        "error_count": 0,
-        "warning_count": 0,
-        "skipped_count": 0,
-        "total_count": 0
-      },
-      "outbound": {
-        "success_count": 0,
-        "error_count": 0,
-        "pending_count": 0,
-        "total_count": 0
-      }
-    }
-  ]
-}
-```
-
-</details>
-
----
-
 ### `getOutboundStatus`
 
 Get the status of all outbound use cases for a specific integration.
@@ -3322,68 +3155,6 @@ const { data } = await client.queryAccessLogs(
 
 ---
 
-### `queryOutboundMonitoringEvents`
-
-Query outbound monitoring events for a specific integration.
-Returns detailed information about outbound event deliveries,
-filtered by event_name (event_catalog_event) linked to the integration's outb
-
-`POST /v1/integrations/{integrationId}/monitoring/outbound-events`
-
-```ts
-const { data } = await client.queryOutboundMonitoringEvents(
-  {
-    integrationId: 'example',
-  },
-  {
-    event_name: 'automation_flow_target',
-    status: 'succeeded',
-    webhook_config_id: 'string',
-    from_date: '2025-01-01T00:00:00Z',
-    to_date: '2025-01-31T23:59:59Z',
-    limit: 50,
-    cursor: {
-      created_at: '1970-01-01T00:00:00.000Z',
-      event_id: 'string'
-    }
-  },
-)
-```
-
-<details>
-<summary>Response</summary>
-
-```json
-{
-  "data": [
-    {
-      "org_id": "string",
-      "event_id": "string",
-      "event_name": "string",
-      "status": "succeeded",
-      "url": "string",
-      "http_method": "string",
-      "http_response": {},
-      "webhook_config_id": "string",
-      "metadata": {},
-      "execution_context": {},
-      "payload": {},
-      "created_at": "1970-01-01T00:00:00.000Z",
-      "updated_at": "1970-01-01T00:00:00.000Z"
-    }
-  ],
-  "next_cursor": {
-    "created_at": "1970-01-01T00:00:00.000Z",
-    "event_id": "string"
-  },
-  "has_more": true
-}
-```
-
-</details>
-
----
-
 ### `queryMonitoringEventsV2`
 
 Query monitoring events from the unified erp_monitoring_v2 table.
@@ -3430,7 +3201,7 @@ const { data } = await client.queryMonitoringEventsV2(
       "use_case_id": "string",
       "use_case_type": "inbound",
       "level": "success",
-      "code": "string",
+      "code": "ACK_CONFIRMED",
       "message": "string",
       "detail": {},
       "created_at": "1970-01-01T00:00:00.000Z"
@@ -3588,7 +3359,7 @@ const { data } = await client.getAssociatedMonitoringEvents({
       "use_case_id": "string",
       "use_case_type": "inbound",
       "level": "success",
-      "code": "string",
+      "code": "ACK_CONFIRMED",
       "message": "string",
       "detail": {},
       "created_at": "1970-01-01T00:00:00.000Z"
@@ -3668,7 +3439,7 @@ const { data } = await client.getMonitoringTraceByCorrelation({
       "use_case_id": "string",
       "use_case_type": "inbound",
       "level": "success",
-      "code": "string",
+      "code": "ACK_CONFIRMED",
       "message": "string",
       "detail": {},
       "created_at": "1970-01-01T00:00:00.000Z"
@@ -3721,7 +3492,8 @@ const { data } = await client.getMonitoringRunCompletionV2(
         "error": 0,
         "warning": 0,
         "success": 0,
-        "info": 0
+        "info": 0,
+        "retry": 0
       },
       "last_activity_at": "1970-01-01T00:00:00.000Z"
     }
@@ -3991,7 +3763,8 @@ const { data } = await client.createErpImport(
           ],
           "attributes": [
             {
-              "name": "string"
+              "name": "string",
+              "entity": "string"
             }
           ],
           "lines": [0],
@@ -4089,7 +3862,8 @@ const { data } = await client.listErpImports({
             ],
             "attributes": [
               {
-                "name": "string"
+                "name": "string",
+                "entity": "string"
               }
             ],
             "lines": [0],
@@ -4180,7 +3954,8 @@ const { data } = await client.getErpImport({
         ],
         "attributes": [
           {
-            "name": "string"
+            "name": "string",
+            "entity": "string"
           }
         ],
         "lines": [0],
@@ -4455,7 +4230,7 @@ deliberately no message to display. Each code appears at most once (once per
 
 ```ts
 type ErpImportIssue = {
-  code: "UNIQUE_ID_COLUMN_MISSING" | "MAPPED_COLUMN_MISSING" | "MALFORMED_ROW" | "INVALID_ENCODING" | "EMPTY_FILE" | "TOO_MANY_ROWS" | "BLANK_ROWS_SKIPPED" | "TIER_ROWS_NOT_GROUPED" | "TIER_BANDS_CONFLICT" | "CONDITION_VALUE_MISSING" | "VARIANT_VALUE_CONFLICT" | "ATTRIBUTE_NOT_OVERRIDABLE" | "ATTRIBUTE_NOT_IN_SCHEMA" | "IS_CONDITIONAL_NOT_CONSTANT" | "SCHEMA_NOT_CONDITIONABLE" | "SCHEMA_NOT_FOUND" | "SCHEMA_DECLARES_NO_CONDITIONS" | "GROUPING_KEY_NOT_A_COLUMN" | "GROUPING_KEY_IS_SORT_COLUMN" | "CONDITIONAL_TARGET_MODE_UNSUPPORTED" | "VALUE_FORMAT_INVALID" | "MAPPING_EXPRESSION_FAILED" | "FROM_ROWS_EXPRESSION_FAILED"
+  code: "UNIQUE_ID_COLUMN_MISSING" | "MAPPED_COLUMN_MISSING" | "MALFORMED_ROW" | "INVALID_ENCODING" | "EMPTY_FILE" | "TOO_MANY_ROWS" | "BLANK_ROWS_SKIPPED" | "TIER_ROWS_NOT_GROUPED" | "TIER_BANDS_CONFLICT" | "CONDITION_VALUE_MISSING" | "VARIANT_VALUE_CONFLICT" | "ATTRIBUTE_NOT_OVERRIDABLE" | "ATTRIBUTE_NOT_IN_SCHEMA" | "IS_CONDITIONAL_NOT_CONSTANT" | "SCHEMA_NOT_CONDITIONABLE" | "SCHEMA_NOT_FOUND" | "SCHEMA_DECLARES_NO_CONDITIONS" | "GROUPING_KEY_NOT_A_COLUMN" | "GROUPING_KEY_IS_SORT_COLUMN" | "CONDITIONAL_TARGET_MODE_UNSUPPORTED" | "UNIQUE_ID_NOT_IN_SCHEMA" | "VALUE_FORMAT_INVALID" | "MAPPING_EXPRESSION_FAILED" | "FROM_ROWS_EXPRESSION_FAILED" | "VALID_FROM_NOT_MAPPED"
   severity: "warning" | "blocking"
   columns?: Array<{
     name: string
@@ -4463,6 +4238,7 @@ type ErpImportIssue = {
   }>
   attributes?: Array<{
     name: string
+    entity?: string
   }>
   lines?: number[]
   subject?: string
@@ -4491,7 +4267,7 @@ type ErpImportValidation = {
     version_attribute?: string
   }>
   issues?: Array<{
-    code: "UNIQUE_ID_COLUMN_MISSING" | "MAPPED_COLUMN_MISSING" | "MALFORMED_ROW" | "INVALID_ENCODING" | "EMPTY_FILE" | "TOO_MANY_ROWS" | "BLANK_ROWS_SKIPPED" | "TIER_ROWS_NOT_GROUPED" | "TIER_BANDS_CONFLICT" | "CONDITION_VALUE_MISSING" | "VARIANT_VALUE_CONFLICT" | "ATTRIBUTE_NOT_OVERRIDABLE" | "ATTRIBUTE_NOT_IN_SCHEMA" | "IS_CONDITIONAL_NOT_CONSTANT" | "SCHEMA_NOT_CONDITIONABLE" | "SCHEMA_NOT_FOUND" | "SCHEMA_DECLARES_NO_CONDITIONS" | "GROUPING_KEY_NOT_A_COLUMN" | "GROUPING_KEY_IS_SORT_COLUMN" | "CONDITIONAL_TARGET_MODE_UNSUPPORTED" | "VALUE_FORMAT_INVALID" | "MAPPING_EXPRESSION_FAILED" | "FROM_ROWS_EXPRESSION_FAILED"
+    code: "UNIQUE_ID_COLUMN_MISSING" | "MAPPED_COLUMN_MISSING" | "MALFORMED_ROW" | "INVALID_ENCODING" | "EMPTY_FILE" | "TOO_MANY_ROWS" | "BLANK_ROWS_SKIPPED" | "TIER_ROWS_NOT_GROUPED" | "TIER_BANDS_CONFLICT" | "CONDITION_VALUE_MISSING" | "VARIANT_VALUE_CONFLICT" | "ATTRIBUTE_NOT_OVERRIDABLE" | "ATTRIBUTE_NOT_IN_SCHEMA" | "IS_CONDITIONAL_NOT_CONSTANT" | "SCHEMA_NOT_CONDITIONABLE" | "SCHEMA_NOT_FOUND" | "SCHEMA_DECLARES_NO_CONDITIONS" | "GROUPING_KEY_NOT_A_COLUMN" | "GROUPING_KEY_IS_SORT_COLUMN" | "CONDITIONAL_TARGET_MODE_UNSUPPORTED" | "UNIQUE_ID_NOT_IN_SCHEMA" | "VALUE_FORMAT_INVALID" | "MAPPING_EXPRESSION_FAILED" | "FROM_ROWS_EXPRESSION_FAILED" | "VALID_FROM_NOT_MAPPED"
     severity: "warning" | "blocking"
     columns?: Array<{
       name: { ... }
@@ -4499,6 +4275,7 @@ type ErpImportValidation = {
     }>
     attributes?: Array<{
       name: { ... }
+      entity?: { ... }
     }>
     lines?: number[]
     subject?: string
@@ -4943,6 +4720,20 @@ type ErpUpdateProcessedEntity = {
 }
 ```
 
+### `CorrelationCloseResult`
+
+What became of the request's `correlation_complete`. Present exactly when the
+request carried `correlation_complete: true`; absent otherwise.
+
+
+```ts
+type CorrelationCloseResult = {
+  outcome: "applied" | "rate_limited" | "ignored"
+  reasons?: "retry_requested" | "queue_refused" | "events_under_own_correlation_ids" | "events_duplicate" | "events_not_configured" | "events_not_interactive" | "events_unrecorded" | "rate_limited" | "rate_limit_unavailable" | "other_integration" | "close_failed" | "interactive_unavailable"[]
+  message?: string
+}
+```
+
 ### `ErpUpdateProcessingError`
 
 A failure nothing will retry.
@@ -4953,6 +4744,7 @@ type ErpUpdateProcessingError = {
   message: string
   event_id?: string
   occurred_at: string // date-time
+  after_completion?: boolean
 }
 ```
 
@@ -4981,12 +4773,15 @@ type ErpUpdateEventStatus = {
     operation: "created" | "updated" | "deleted" | "unchanged"
     unique_ids: Record<string, string>
   }>
+  entities_omitted?: number
   errors: Array<{
     code: string
     message: string
     event_id?: string
     occurred_at: string // date-time
+    after_completion?: boolean
   }>
+  errors_total: number
 }
 ```
 
@@ -5013,6 +4808,8 @@ type CorrelationStatus = {
   integration_id?: string
   closed: boolean
   closed_at?: string // date-time
+  complete: boolean
+  completed_at?: string // date-time
   events_received: number
   events_done: number
   late_events: number
@@ -5030,12 +4827,15 @@ type CorrelationStatus = {
     operation: "created" | "updated" | "deleted" | "unchanged"
     unique_ids: Record<string, string>
   }>
+  entities_omitted?: number
   errors: Array<{
     code: string
     message: string
     event_id?: string
     occurred_at: string // date-time
+    after_completion?: boolean
   }>
+  errors_total: number
 }
 ```
 
@@ -5047,6 +4847,8 @@ type CorrelationWaitResult = {
   integration_id?: string
   closed: boolean
   closed_at?: string // date-time
+  complete: boolean
+  completed_at?: string // date-time
   events_received: number
   events_done: number
   late_events: number
@@ -5064,13 +4866,17 @@ type CorrelationWaitResult = {
     operation: "created" | "updated" | "deleted" | "unchanged"
     unique_ids: Record<string, string>
   }>
+  entities_omitted?: number
   errors: Array<{
     code: string
     message: string
     event_id?: string
     occurred_at: string // date-time
+    after_completion?: boolean
   }>
+  errors_total: number
   completion: "requirements_met" | "complete" | "timeout" | "error"
+  undecided_entity_requirements?: string[]
 }
 ```
 
@@ -5081,6 +4887,7 @@ type CorrelationWaitBadRequest = {
   message: string
   slug?: string
   rejected_key?: string
+  use_case_slug?: string
   allowed_keys?: string[]
 }
 ```
@@ -5094,6 +4901,8 @@ type CorrelationStatusList = {
     integration_id?: string
     closed: boolean
     closed_at?: string // date-time
+    complete: boolean
+    completed_at?: string // date-time
     events_received: number
     events_done: number
     late_events: number
@@ -5111,12 +4920,15 @@ type CorrelationStatusList = {
       operation: { ... }
       unique_ids: { ... }
     }>
+    entities_omitted?: number
     errors: Array<{
       code: { ... }
       message: { ... }
       event_id?: { ... }
       occurred_at: { ... }
+      after_completion?: { ... }
     }>
+    errors_total: number
   }>
   next_cursor: string
   horizon_days: number
@@ -6332,6 +6144,7 @@ type IntegrationEntityField = {
       entity_schema: { ... }
       _tags?: { ... }
       unique_ids: { ... }
+      required?: { ... }
     }>
     jsonataExpression?: string
   }
@@ -9670,6 +9483,7 @@ type RelationConfig = {
       jsonataExpression?: { ... }
       constant?: { ... }
     }>
+    required?: boolean
   }>
   jsonataExpression?: string
 }
@@ -9688,6 +9502,7 @@ type RelationItemConfig = {
     jsonataExpression?: string
     constant?: unknown
   }>
+  required?: boolean
 }
 ```
 
@@ -10084,7 +9899,7 @@ type MonitoringTraceResponse = {
     use_case_id?: string
     use_case_type: "inbound" | "outbound" | "file_proxy" | "managed_call" | "secure_proxy" | ""
     level: "success" | "error" | "info" | "warning"
-    code?: string
+    code?: "ACK_CONFIRMED" | "ACK_PENDING" | "ACK_TIMEOUT" | "ATTACHMENT_NOT_FOUND" | "ATTRIBUTE_TYPE_MISMATCH" | "CONDITIONAL_VARIANTS_WRITTEN" | "CONDITIONAL_VARIANT_WRITE_FAILED" | "CONDITIONAL_VARIANT_WRITE_WARNING" | "CORRELATION_CLOSED_EMPTY" | "CORRELATION_CLOSED_INCOMPLETE" | "CORRELATION_CLOSE_IGNORED" | "CORRELATION_COMPLETED" | "CORRELATION_EVENT_LIMIT_EXCEEDED" | "CORRELATION_ID_MISSING" | "CORRELATION_LATE_EVENT" | "CORRELATION_REQUIREMENT_FAILED" | "CORRELATION_WAIT_REJECTED" | "CORRELATION_WAIT_TIMEOUT" | "DEPRECATED_ENDPOINT" | "DIRECT_ENTITY_NOT_ALLOWED" | "DIRECT_PAYLOAD_INVALID" | "DIRECT_VERSION_UNSUPPORTED" | "DUPLICATE_EVENT" | "ENTITY_CREATED" | "ENTITY_DELETED" | "ENTITY_NO_OP" | "ENTITY_REFERENCE_NOT_FOUND" | "ENTITY_UPDATED" | "EVENT_NOT_CONFIGURED" | "EXTERNAL_API_ERROR" | "EXTERNAL_ERROR" | "EXTERNAL_INFO" | "EXTERNAL_SUCCESS" | "EXTERNAL_WARNING" | "FAN_OUT_EMPTY" | "FAN_OUT_INVALID_RESULT" | "FILE_EXTRACTION_FAILED" | "FILE_FETCH_FAILED" | "FILE_PROXY_OK" | "FILE_PROXY_UPLOADED" | "FILE_PROXY_UPLOAD_ENQUEUED" | "FILE_PROXY_UPLOAD_FAILED" | "FILE_PROXY_UPLOAD_RETRYING" | "FILE_TOO_LARGE" | "INTEGRATION_NOT_FOUND" | "INTERACTIVE_CROSS_LANE_WRITE" | "INTERACTIVE_NOT_ALLOWED" | "INTERACTIVE_RATE_LIMITED" | "INVALID_METER_READING_ATTRIBUTES" | "LOOKUP_UNMAPPED" | "MALFORMED_PAYLOAD" | "MAPPING_EXPRESSION_FAILED" | "METERING_API_ERROR" | "METER_READING_DELETED" | "METER_READING_GROUP_FAILED" | "METER_READING_GROUP_RETRYING" | "METER_READING_UPSERTED" | "MISSING_REQUIRED_PARAM" | "MISSING_UNIQUE_IDENTIFIERS" | "MSG_ACKED" | "MSG_DEAD_LETTERED" | "MSG_ENQUEUED" | "MSG_EXPIRED_UNPOLLED" | "MSG_HEAD_BLOCKED" | "MSG_LATE_ARRIVAL" | "OAUTH2_TOKEN_FAILURE" | "PAYLOAD_TOO_LARGE" | "PROCESSING_STATE_LIMIT" | "PRUNE_SCOPE_COMPLETED" | "PRUNE_SCOPE_PARTIAL_FAILURE" | "RECURSION_DEPTH_EXCEEDED" | "RELATION_REF_ITEM_NOT_FOUND" | "RELATION_REF_VALUE_UNDEFINED" | "REQUIRED_PARAM_MISSING" | "SECURE_PROXY_DISABLED" | "SECURE_PROXY_DOMAIN_BLOCKED" | "SECURE_PROXY_DOMAIN_NOT_ALLOWED" | "SECURE_PROXY_ERROR" | "SECURE_PROXY_INVALID_CONFIG" | "SECURE_PROXY_INVALID_TYPE" | "SECURE_PROXY_INVALID_URL" | "SECURE_PROXY_IP_BLOCKED" | "SECURE_PROXY_IP_NOT_ALLOWED" | "SECURE_PROXY_NOT_FOUND" | "SECURE_PROXY_UNAVAILABLE" | "SIGNATURE_VERIFICATION_FAILED" | "SIGNATURE_VERIFICATION_UNAVAILABLE" | "SOFT_DELETED_ENTITY_MATCHED" | "STEP_DISABLED" | "TIMEOUT" | "UNIQUE_ID_LOOKUP_UNRESOLVABLE" | "UNIQUE_ID_MULTIPLE_MATCHES" | "UNIQUE_ID_NOT_IN_SCHEMA" | "UNKNOWN_ERROR" | "USE_CASE_DISABLED" | "USE_CASE_INVALID_TYPE" | "USE_CASE_MISSING_CONFIG" | "USE_CASE_NOT_FOUND" | "WEBHOOK_DELIVERED" | string
     message?: string
     detail?: Record<string, unknown>
     created_at: string // date-time
@@ -10099,11 +9914,11 @@ The monitoring code taxonomy — every code the Integration Toolkit itself emits
 with a fixed level (see the published code reference at
 https://docs.epilot.io/docs/integrations/integration-toolkit/monitoring/codes).
 
-This schema exists so consumers can import the union as a type. It is
-deliberately 
+This schema exists so consumers can import the union as a type. It never
+constrains
 
 ```ts
-type MonitoringCode = "ACK_CONFIRMED" | "ACK_PENDING" | "ACK_TIMEOUT" | "ATTACHMENT_NOT_FOUND" | "ATTRIBUTE_TYPE_MISMATCH" | "CONDITIONAL_VARIANTS_WRITTEN" | "CONDITIONAL_VARIANT_WRITE_FAILED" | "CONDITIONAL_VARIANT_WRITE_WARNING" | "CORRELATION_CLOSED_EMPTY" | "CORRELATION_CLOSED_INCOMPLETE" | "CORRELATION_CLOSE_IGNORED" | "CORRELATION_COMPLETED" | "CORRELATION_EVENT_LIMIT_EXCEEDED" | "CORRELATION_ID_MISSING" | "CORRELATION_LATE_EVENT" | "CORRELATION_REQUIREMENT_FAILED" | "CORRELATION_WAIT_REJECTED" | "CORRELATION_WAIT_TIMEOUT" | "DEPRECATED_ENDPOINT" | "DIRECT_ENTITY_NOT_ALLOWED" | "DIRECT_PAYLOAD_INVALID" | "DIRECT_VERSION_UNSUPPORTED" | "DUPLICATE_EVENT" | "ENTITY_CREATED" | "ENTITY_DELETED" | "ENTITY_NO_OP" | "ENTITY_REFERENCE_NOT_FOUND" | "ENTITY_UPDATED" | "EVENT_NOT_CONFIGURED" | "EXTERNAL_API_ERROR" | "EXTERNAL_ERROR" | "EXTERNAL_INFO" | "EXTERNAL_SUCCESS" | "EXTERNAL_WARNING" | "FAN_OUT_EMPTY" | "FAN_OUT_INVALID_RESULT" | "FILE_EXTRACTION_FAILED" | "FILE_FETCH_FAILED" | "FILE_PROXY_OK" | "FILE_PROXY_UPLOADED" | "FILE_PROXY_UPLOAD_ENQUEUED" | "FILE_PROXY_UPLOAD_FAILED" | "FILE_PROXY_UPLOAD_RETRYING" | "FILE_TOO_LARGE" | "INTEGRATION_NOT_FOUND" | "INTERACTIVE_CROSS_LANE_WRITE" | "INTERACTIVE_NOT_ALLOWED" | "INTERACTIVE_RATE_LIMITED" | "INVALID_METER_READING_ATTRIBUTES" | "LOOKUP_UNMAPPED" | "MALFORMED_PAYLOAD" | "MAPPING_EXPRESSION_FAILED" | "METERING_API_ERROR" | "METER_READING_DELETED" | "METER_READING_GROUP_FAILED" | "METER_READING_GROUP_RETRYING" | "METER_READING_UPSERTED" | "MISSING_REQUIRED_PARAM" | "MISSING_UNIQUE_IDENTIFIERS" | "MSG_ACKED" | "MSG_DEAD_LETTERED" | "MSG_ENQUEUED" | "MSG_EXPIRED_UNPOLLED" | "MSG_HEAD_BLOCKED" | "MSG_LATE_ARRIVAL" | "OAUTH2_TOKEN_FAILURE" | "PAYLOAD_TOO_LARGE" | "PRUNE_SCOPE_COMPLETED" | "PRUNE_SCOPE_PARTIAL_FAILURE" | "RECURSION_DEPTH_EXCEEDED" | "RELATION_REF_ITEM_NOT_FOUND" | "RELATION_REF_VALUE_UNDEFINED" | "REQUIRED_PARAM_MISSING" | "SECURE_PROXY_DISABLED" | "SECURE_PROXY_DOMAIN_BLOCKED" | "SECURE_PROXY_DOMAIN_NOT_ALLOWED" | "SECURE_PROXY_ERROR" | "SECURE_PROXY_INVALID_CONFIG" | "SECURE_PROXY_INVALID_TYPE" | "SECURE_PROXY_INVALID_URL" | "SECURE_PROXY_IP_BLOCKED" | "SECURE_PROXY_IP_NOT_ALLOWED" | "SECURE_PROXY_NOT_FOUND" | "SECURE_PROXY_UNAVAILABLE" | "SIGNATURE_VERIFICATION_FAILED" | "SIGNATURE_VERIFICATION_UNAVAILABLE" | "SOFT_DELETED_ENTITY_MATCHED" | "STEP_DISABLED" | "TIMEOUT" | "UNIQUE_ID_LOOKUP_UNRESOLVABLE" | "UNIQUE_ID_MULTIPLE_MATCHES" | "UNIQUE_ID_NOT_IN_SCHEMA" | "UNKNOWN_ERROR" | "USE_CASE_DISABLED" | "USE_CASE_INVALID_TYPE" | "USE_CASE_MISSING_CONFIG" | "USE_CASE_NOT_FOUND" | "WEBHOOK_DELIVERED"
+type MonitoringCode = "ACK_CONFIRMED" | "ACK_PENDING" | "ACK_TIMEOUT" | "ATTACHMENT_NOT_FOUND" | "ATTRIBUTE_TYPE_MISMATCH" | "CONDITIONAL_VARIANTS_WRITTEN" | "CONDITIONAL_VARIANT_WRITE_FAILED" | "CONDITIONAL_VARIANT_WRITE_WARNING" | "CORRELATION_CLOSED_EMPTY" | "CORRELATION_CLOSED_INCOMPLETE" | "CORRELATION_CLOSE_IGNORED" | "CORRELATION_COMPLETED" | "CORRELATION_EVENT_LIMIT_EXCEEDED" | "CORRELATION_ID_MISSING" | "CORRELATION_LATE_EVENT" | "CORRELATION_REQUIREMENT_FAILED" | "CORRELATION_WAIT_REJECTED" | "CORRELATION_WAIT_TIMEOUT" | "DEPRECATED_ENDPOINT" | "DIRECT_ENTITY_NOT_ALLOWED" | "DIRECT_PAYLOAD_INVALID" | "DIRECT_VERSION_UNSUPPORTED" | "DUPLICATE_EVENT" | "ENTITY_CREATED" | "ENTITY_DELETED" | "ENTITY_NO_OP" | "ENTITY_REFERENCE_NOT_FOUND" | "ENTITY_UPDATED" | "EVENT_NOT_CONFIGURED" | "EXTERNAL_API_ERROR" | "EXTERNAL_ERROR" | "EXTERNAL_INFO" | "EXTERNAL_SUCCESS" | "EXTERNAL_WARNING" | "FAN_OUT_EMPTY" | "FAN_OUT_INVALID_RESULT" | "FILE_EXTRACTION_FAILED" | "FILE_FETCH_FAILED" | "FILE_PROXY_OK" | "FILE_PROXY_UPLOADED" | "FILE_PROXY_UPLOAD_ENQUEUED" | "FILE_PROXY_UPLOAD_FAILED" | "FILE_PROXY_UPLOAD_RETRYING" | "FILE_TOO_LARGE" | "INTEGRATION_NOT_FOUND" | "INTERACTIVE_CROSS_LANE_WRITE" | "INTERACTIVE_NOT_ALLOWED" | "INTERACTIVE_RATE_LIMITED" | "INVALID_METER_READING_ATTRIBUTES" | "LOOKUP_UNMAPPED" | "MALFORMED_PAYLOAD" | "MAPPING_EXPRESSION_FAILED" | "METERING_API_ERROR" | "METER_READING_DELETED" | "METER_READING_GROUP_FAILED" | "METER_READING_GROUP_RETRYING" | "METER_READING_UPSERTED" | "MISSING_REQUIRED_PARAM" | "MISSING_UNIQUE_IDENTIFIERS" | "MSG_ACKED" | "MSG_DEAD_LETTERED" | "MSG_ENQUEUED" | "MSG_EXPIRED_UNPOLLED" | "MSG_HEAD_BLOCKED" | "MSG_LATE_ARRIVAL" | "OAUTH2_TOKEN_FAILURE" | "PAYLOAD_TOO_LARGE" | "PROCESSING_STATE_LIMIT" | "PRUNE_SCOPE_COMPLETED" | "PRUNE_SCOPE_PARTIAL_FAILURE" | "RECURSION_DEPTH_EXCEEDED" | "RELATION_REF_ITEM_NOT_FOUND" | "RELATION_REF_VALUE_UNDEFINED" | "REQUIRED_PARAM_MISSING" | "SECURE_PROXY_DISABLED" | "SECURE_PROXY_DOMAIN_BLOCKED" | "SECURE_PROXY_DOMAIN_NOT_ALLOWED" | "SECURE_PROXY_ERROR" | "SECURE_PROXY_INVALID_CONFIG" | "SECURE_PROXY_INVALID_TYPE" | "SECURE_PROXY_INVALID_URL" | "SECURE_PROXY_IP_BLOCKED" | "SECURE_PROXY_IP_NOT_ALLOWED" | "SECURE_PROXY_NOT_FOUND" | "SECURE_PROXY_UNAVAILABLE" | "SIGNATURE_VERIFICATION_FAILED" | "SIGNATURE_VERIFICATION_UNAVAILABLE" | "SOFT_DELETED_ENTITY_MATCHED" | "STEP_DISABLED" | "TIMEOUT" | "UNIQUE_ID_LOOKUP_UNRESOLVABLE" | "UNIQUE_ID_MULTIPLE_MATCHES" | "UNIQUE_ID_NOT_IN_SCHEMA" | "UNKNOWN_ERROR" | "USE_CASE_DISABLED" | "USE_CASE_INVALID_TYPE" | "USE_CASE_MISSING_CONFIG" | "USE_CASE_NOT_FOUND" | "WEBHOOK_DELIVERED"
 ```
 
 ### `MonitoringEventV2`
@@ -10118,7 +9933,7 @@ type MonitoringEventV2 = {
   use_case_id?: string
   use_case_type: "inbound" | "outbound" | "file_proxy" | "managed_call" | "secure_proxy" | ""
   level: "success" | "error" | "info" | "warning"
-  code?: string
+  code?: "ACK_CONFIRMED" | "ACK_PENDING" | "ACK_TIMEOUT" | "ATTACHMENT_NOT_FOUND" | "ATTRIBUTE_TYPE_MISMATCH" | "CONDITIONAL_VARIANTS_WRITTEN" | "CONDITIONAL_VARIANT_WRITE_FAILED" | "CONDITIONAL_VARIANT_WRITE_WARNING" | "CORRELATION_CLOSED_EMPTY" | "CORRELATION_CLOSED_INCOMPLETE" | "CORRELATION_CLOSE_IGNORED" | "CORRELATION_COMPLETED" | "CORRELATION_EVENT_LIMIT_EXCEEDED" | "CORRELATION_ID_MISSING" | "CORRELATION_LATE_EVENT" | "CORRELATION_REQUIREMENT_FAILED" | "CORRELATION_WAIT_REJECTED" | "CORRELATION_WAIT_TIMEOUT" | "DEPRECATED_ENDPOINT" | "DIRECT_ENTITY_NOT_ALLOWED" | "DIRECT_PAYLOAD_INVALID" | "DIRECT_VERSION_UNSUPPORTED" | "DUPLICATE_EVENT" | "ENTITY_CREATED" | "ENTITY_DELETED" | "ENTITY_NO_OP" | "ENTITY_REFERENCE_NOT_FOUND" | "ENTITY_UPDATED" | "EVENT_NOT_CONFIGURED" | "EXTERNAL_API_ERROR" | "EXTERNAL_ERROR" | "EXTERNAL_INFO" | "EXTERNAL_SUCCESS" | "EXTERNAL_WARNING" | "FAN_OUT_EMPTY" | "FAN_OUT_INVALID_RESULT" | "FILE_EXTRACTION_FAILED" | "FILE_FETCH_FAILED" | "FILE_PROXY_OK" | "FILE_PROXY_UPLOADED" | "FILE_PROXY_UPLOAD_ENQUEUED" | "FILE_PROXY_UPLOAD_FAILED" | "FILE_PROXY_UPLOAD_RETRYING" | "FILE_TOO_LARGE" | "INTEGRATION_NOT_FOUND" | "INTERACTIVE_CROSS_LANE_WRITE" | "INTERACTIVE_NOT_ALLOWED" | "INTERACTIVE_RATE_LIMITED" | "INVALID_METER_READING_ATTRIBUTES" | "LOOKUP_UNMAPPED" | "MALFORMED_PAYLOAD" | "MAPPING_EXPRESSION_FAILED" | "METERING_API_ERROR" | "METER_READING_DELETED" | "METER_READING_GROUP_FAILED" | "METER_READING_GROUP_RETRYING" | "METER_READING_UPSERTED" | "MISSING_REQUIRED_PARAM" | "MISSING_UNIQUE_IDENTIFIERS" | "MSG_ACKED" | "MSG_DEAD_LETTERED" | "MSG_ENQUEUED" | "MSG_EXPIRED_UNPOLLED" | "MSG_HEAD_BLOCKED" | "MSG_LATE_ARRIVAL" | "OAUTH2_TOKEN_FAILURE" | "PAYLOAD_TOO_LARGE" | "PROCESSING_STATE_LIMIT" | "PRUNE_SCOPE_COMPLETED" | "PRUNE_SCOPE_PARTIAL_FAILURE" | "RECURSION_DEPTH_EXCEEDED" | "RELATION_REF_ITEM_NOT_FOUND" | "RELATION_REF_VALUE_UNDEFINED" | "REQUIRED_PARAM_MISSING" | "SECURE_PROXY_DISABLED" | "SECURE_PROXY_DOMAIN_BLOCKED" | "SECURE_PROXY_DOMAIN_NOT_ALLOWED" | "SECURE_PROXY_ERROR" | "SECURE_PROXY_INVALID_CONFIG" | "SECURE_PROXY_INVALID_TYPE" | "SECURE_PROXY_INVALID_URL" | "SECURE_PROXY_IP_BLOCKED" | "SECURE_PROXY_IP_NOT_ALLOWED" | "SECURE_PROXY_NOT_FOUND" | "SECURE_PROXY_UNAVAILABLE" | "SIGNATURE_VERIFICATION_FAILED" | "SIGNATURE_VERIFICATION_UNAVAILABLE" | "SOFT_DELETED_ENTITY_MATCHED" | "STEP_DISABLED" | "TIMEOUT" | "UNIQUE_ID_LOOKUP_UNRESOLVABLE" | "UNIQUE_ID_MULTIPLE_MATCHES" | "UNIQUE_ID_NOT_IN_SCHEMA" | "UNKNOWN_ERROR" | "USE_CASE_DISABLED" | "USE_CASE_INVALID_TYPE" | "USE_CASE_MISSING_CONFIG" | "USE_CASE_NOT_FOUND" | "WEBHOOK_DELIVERED" | string
   message?: string
   detail?: Record<string, unknown>
   created_at: string // date-time
@@ -10167,6 +9982,7 @@ type MonitoringRunCompletionV2Response = {
       warning: { ... }
       success: { ... }
       info: { ... }
+      retry: { ... }
     }
     last_activity_at: string // date-time
   }>
@@ -10193,6 +10009,7 @@ type MonitoringRunCompletionV2 = {
     warning: number
     success: number
     info: number
+    retry: number
   }
   last_activity_at: string // date-time
 }
@@ -10200,7 +10017,7 @@ type MonitoringRunCompletionV2 = {
 
 ### `MonitoringRunEntriesV2`
 
-The run's monitoring rows counted by level, retry markers included — the same rows its trace lists. Unlike the event counts above, one event can contribute many rows (one per entity written, plus every caveat and retry).
+The run's monitoring rows counted by level — the rows its trace lists, correlation-level rows (wait outcomes, closes) included. Unlike the event counts above, one event can contribute many rows (one per entity written, plus every caveat and retry). Retry markers count under `retry` only, so a failed
 
 ```ts
 type MonitoringRunEntriesV2 = {
@@ -10209,6 +10026,7 @@ type MonitoringRunEntriesV2 = {
   warning: number
   success: number
   info: number
+  retry: number
 }
 ```