@epilot/sdk 2.18.15 → 2.18.17

package/definitions/integration-toolkit-runtime.json

@@ -1 +1 @@
-{"s":"https://integration-toolkit.sls.epilot.io","o":[["acknowledgeTracking","post","/v1/erp/tracking/acknowledgement",null,1],["triggerErp","post","/v1/erp/trigger",null,1],["processErpUpdatesEvents","post","/v1/erp/updates/events",null,1],["processErpUpdatesEventsV2","post","/v2/erp/updates/events",null,1],["processErpUpdatesEventsV3","post","/v3/erp/updates/events",null,1],["simulateMappingV2","post","/v2/erp/updates/mapping_simulation",null,1],["simulateMapping","post","/v1/erp/updates/mapping_simulation",null,1],["listIntegrations","get","/v1/integrations"],["createIntegration","post","/v1/integrations",null,1],["getIntegration","get","/v1/integrations/{integrationId}",[["integrationId","p",true]]],["updateIntegration","put","/v1/integrations/{integrationId}",[["integrationId","p",true]],1],["deleteIntegration","delete","/v1/integrations/{integrationId}",[["integrationId","p",true]]],["queryEvents","post","/v1/integrations/{integrationId}/events",[["integrationId","p",true]],1],["replayEvents","post","/v1/integrations/{integrationId}/events/replay",[["integrationId","p",true]],1],["listUseCases","get","/v1/integrations/{integrationId}/use-cases",[["integrationId","p",true]]],["createUseCase","post","/v1/integrations/{integrationId}/use-cases",[["integrationId","p",true]],1],["getUseCase","get","/v1/integrations/{integrationId}/use-cases/{useCaseId}",[["integrationId","p",true],["useCaseId","p",true]]],["updateUseCase","put","/v1/integrations/{integrationId}/use-cases/{useCaseId}",[["integrationId","p",true],["useCaseId","p",true]],1],["deleteUseCase","delete","/v1/integrations/{integrationId}/use-cases/{useCaseId}",[["integrationId","p",true],["useCaseId","p",true]]],["listUseCaseHistory","get","/v1/integrations/{integrationId}/use-cases/{useCaseId}/history",[["integrationId","p",true],["useCaseId","p",true],["cursor","q"]]],["listIntegrationsV2","get","/v2/integrations"],["createIntegrationV2","post","/v2/integrations",null,1],["getIntegrationV2","get","/v2/integrations/{integrationId}",[["integrationId","p",true]]],["updateIntegrationV2","put","/v2/integrations/{integrationId}",[["integrationId","p",true]],1],["deleteIntegrationV2","delete","/v2/integrations/{integrationId}",[["integrationId","p",true]]],["listNotificationHistory","get","/v2/integrations/{integrationId}/notifications/history",[["integrationId","p",true],["cursor","q"],["limit","q"],["type","q"]]],["testSendNotification","post","/v2/integrations/{integrationId}/notifications/test",[["integrationId","p",true]],1],["getNotificationStatus","get","/v2/integrations/{integrationId}/notifications/status",[["integrationId","p",true],["include","q"]]],["getSecureProxyWhitelist","get","/v2/integrations/{integrationId}/use-cases/{useCaseId}/secure-proxy-whitelist",[["integrationId","p",true],["useCaseId","p",true]]],["updateSecureProxyWhitelist","put","/v2/integrations/{integrationId}/use-cases/{useCaseId}/secure-proxy-whitelist",[["integrationId","p",true],["useCaseId","p",true]],1],["listSecureProxyWhitelistHistory","get","/v2/integrations/{integrationId}/use-cases/{useCaseId}/secure-proxy-whitelist/history",[["integrationId","p",true],["useCaseId","p",true],["limit","q"]]],["setIntegrationAppMapping","put","/v1/integrations/{integrationId}/app-mapping",[["integrationId","p",true]],1],["deleteIntegrationAppMapping","delete","/v1/integrations/{integrationId}/app-mapping",[["integrationId","p",true]],1],["queryInboundMonitoringEvents","post","/v1/integrations/{integrationId}/monitoring/inbound-events",[["integrationId","p",true]],1],["getMonitoringStats","post","/v1/integrations/{integrationId}/monitoring/stats",[["integrationId","p",true]],1],["getMonitoringTimeSeries","post","/v1/integrations/{integrationId}/monitoring/timeseries",[["integrationId","p",true]],1],["getOutboundStatus","get","/v1/integrations/{integrationId}/outbound-status",[["integrationId","p",true]]],["pollOutboundMessages","post","/v1/integrations/{integrationId}/outbound/messages/poll",[["integrationId","p",true]],1],["ackOutboundMessages","post","/v1/integrations/{integrationId}/outbound/messages/ack",[["integrationId","p",true]],1],["listOutboundDlqMessages","get","/v1/integrations/{integrationId}/outbound/messages/dlq",[["integrationId","p",true],["limit","q"],["next_token","q"]]],["redriveOutboundDlqMessages","post","/v1/integrations/{integrationId}/outbound/messages/dlq/redrive",[["integrationId","p",true]],1],["unblockOutboundStream","post","/v1/integrations/{integrationId}/outbound/messages/unblock",[["integrationId","p",true]],1],["queryAccessLogs","post","/v1/integrations/{integrationId}/monitoring/access-logs",[["integrationId","p",true]],1],["queryOutboundMonitoringEvents","post","/v1/integrations/{integrationId}/monitoring/outbound-events",[["integrationId","p",true]],1],["queryMonitoringEventsV2","post","/v2/integrations/{integrationId}/monitoring/events",[["integrationId","p",true]],1],["getMonitoringStatsV2","post","/v2/integrations/{integrationId}/monitoring/stats",[["integrationId","p",true]],1],["getMonitoringTimeSeriesV2","post","/v2/integrations/{integrationId}/monitoring/time-series",[["integrationId","p",true]],1],["getAssociatedMonitoringEvents","get","/v2/integrations/{integrationId}/monitoring/events/{eventId}/associated",[["integrationId","p",true],["eventId","p",true]]],["ingestExternalMonitoringEvents","post","/v2/integrations/{integrationId}/monitoring/external-events",[["integrationId","p",true]],1],["getMonitoringTraceByCorrelation","get","/v2/integrations/{integrationId}/monitoring/traces/{correlationId}",[["integrationId","p",true],["correlationId","p",true]]],["listSecureProxies","get","/v1/integrations/secure-proxies"],["secureProxy","post","/v1/secure-proxy",null,1],["managedCallExecute","post","/v1/managed-call/{slug}/execute",[["slug","p",true]],1],["generateTypesPreview","post","/v1/integrations/{integrationId}/generate-types-preview",[["integrationId","p",true]]],["generateTypes","post","/v1/integrations/{integrationId}/generate-types",[["integrationId","p",true]],1],["commitTypes","post","/v1/integrations/{integrationId}/commit-types",[["integrationId","p",true]],1],["createErpImport","post","/v2/erp/imports",null,1],["listErpImports","get","/v2/erp/imports",[["limit","q"],["cursor","q"]]],["getErpImport","get","/v2/erp/imports/{importId}",[["importId","p",true]]],["validateErpImport","post","/v2/erp/imports/{importId}:validate",[["importId","p",true]],1],["suggestErpImportUseCases","post","/v2/erp/imports/{importId}:suggest-use-cases",[["importId","p",true]]],["executeErpImport","post","/v2/erp/imports/{importId}:execute",[["importId","p",true]],1],["abortErpImport","post","/v2/erp/imports/{importId}:abort",[["importId","p",true]]]],"v":"3.0.3"}
+{"s":"https://integration-toolkit.sls.epilot.io","o":[["acknowledgeTracking","post","/v1/erp/tracking/acknowledgement",null,1],["triggerErp","post","/v1/erp/trigger",null,1],["processErpUpdatesEvents","post","/v1/erp/updates/events",null,1],["processErpUpdatesEventsV2","post","/v2/erp/updates/events",null,1],["processErpUpdatesEventsV3","post","/v3/erp/updates/events",null,1],["simulateMappingV2","post","/v2/erp/updates/mapping_simulation",null,1],["simulateMapping","post","/v1/erp/updates/mapping_simulation",null,1],["listIntegrations","get","/v1/integrations"],["createIntegration","post","/v1/integrations",null,1],["getIntegration","get","/v1/integrations/{integrationId}",[["integrationId","p",true]]],["updateIntegration","put","/v1/integrations/{integrationId}",[["integrationId","p",true]],1],["deleteIntegration","delete","/v1/integrations/{integrationId}",[["integrationId","p",true]]],["queryEvents","post","/v1/integrations/{integrationId}/events",[["integrationId","p",true]],1],["replayEvents","post","/v1/integrations/{integrationId}/events/replay",[["integrationId","p",true]],1],["listUseCases","get","/v1/integrations/{integrationId}/use-cases",[["integrationId","p",true]]],["createUseCase","post","/v1/integrations/{integrationId}/use-cases",[["integrationId","p",true]],1],["getUseCase","get","/v1/integrations/{integrationId}/use-cases/{useCaseId}",[["integrationId","p",true],["useCaseId","p",true]]],["updateUseCase","put","/v1/integrations/{integrationId}/use-cases/{useCaseId}",[["integrationId","p",true],["useCaseId","p",true]],1],["deleteUseCase","delete","/v1/integrations/{integrationId}/use-cases/{useCaseId}",[["integrationId","p",true],["useCaseId","p",true]]],["listUseCaseHistory","get","/v1/integrations/{integrationId}/use-cases/{useCaseId}/history",[["integrationId","p",true],["useCaseId","p",true],["cursor","q"]]],["listDocumentationPages","get","/v1/integrations/{integrationId}/documentation",[["integrationId","p",true]]],["getDocumentationPage","get","/v1/integrations/{integrationId}/documentation/{docId}",[["integrationId","p",true],["docId","p",true]]],["upsertDocumentationPage","put","/v1/integrations/{integrationId}/documentation/{docId}",[["integrationId","p",true],["docId","p",true]],1],["deleteDocumentationPage","delete","/v1/integrations/{integrationId}/documentation/{docId}",[["integrationId","p",true],["docId","p",true]]],["listIntegrationsV2","get","/v2/integrations"],["createIntegrationV2","post","/v2/integrations",null,1],["getIntegrationV2","get","/v2/integrations/{integrationId}",[["integrationId","p",true]]],["updateIntegrationV2","put","/v2/integrations/{integrationId}",[["integrationId","p",true]],1],["deleteIntegrationV2","delete","/v2/integrations/{integrationId}",[["integrationId","p",true]]],["listNotificationHistory","get","/v2/integrations/{integrationId}/notifications/history",[["integrationId","p",true],["cursor","q"],["limit","q"],["type","q"]]],["testSendNotification","post","/v2/integrations/{integrationId}/notifications/test",[["integrationId","p",true]],1],["getNotificationStatus","get","/v2/integrations/{integrationId}/notifications/status",[["integrationId","p",true],["include","q"]]],["getSecureProxyWhitelist","get","/v2/integrations/{integrationId}/use-cases/{useCaseId}/secure-proxy-whitelist",[["integrationId","p",true],["useCaseId","p",true]]],["updateSecureProxyWhitelist","put","/v2/integrations/{integrationId}/use-cases/{useCaseId}/secure-proxy-whitelist",[["integrationId","p",true],["useCaseId","p",true]],1],["listSecureProxyWhitelistHistory","get","/v2/integrations/{integrationId}/use-cases/{useCaseId}/secure-proxy-whitelist/history",[["integrationId","p",true],["useCaseId","p",true],["limit","q"]]],["setIntegrationAppMapping","put","/v1/integrations/{integrationId}/app-mapping",[["integrationId","p",true]],1],["deleteIntegrationAppMapping","delete","/v1/integrations/{integrationId}/app-mapping",[["integrationId","p",true]],1],["queryInboundMonitoringEvents","post","/v1/integrations/{integrationId}/monitoring/inbound-events",[["integrationId","p",true]],1],["getMonitoringStats","post","/v1/integrations/{integrationId}/monitoring/stats",[["integrationId","p",true]],1],["getMonitoringTimeSeries","post","/v1/integrations/{integrationId}/monitoring/timeseries",[["integrationId","p",true]],1],["getOutboundStatus","get","/v1/integrations/{integrationId}/outbound-status",[["integrationId","p",true]]],["pollOutboundMessages","post","/v1/integrations/{integrationId}/outbound/messages/poll",[["integrationId","p",true]],1],["ackOutboundMessages","post","/v1/integrations/{integrationId}/outbound/messages/ack",[["integrationId","p",true]],1],["listOutboundDlqMessages","get","/v1/integrations/{integrationId}/outbound/messages/dlq",[["integrationId","p",true],["limit","q"],["next_token","q"]]],["redriveOutboundDlqMessages","post","/v1/integrations/{integrationId}/outbound/messages/dlq/redrive",[["integrationId","p",true]],1],["unblockOutboundStream","post","/v1/integrations/{integrationId}/outbound/messages/unblock",[["integrationId","p",true]],1],["queryAccessLogs","post","/v1/integrations/{integrationId}/monitoring/access-logs",[["integrationId","p",true]],1],["queryOutboundMonitoringEvents","post","/v1/integrations/{integrationId}/monitoring/outbound-events",[["integrationId","p",true]],1],["queryMonitoringEventsV2","post","/v2/integrations/{integrationId}/monitoring/events",[["integrationId","p",true]],1],["getMonitoringStatsV2","post","/v2/integrations/{integrationId}/monitoring/stats",[["integrationId","p",true]],1],["getMonitoringTimeSeriesV2","post","/v2/integrations/{integrationId}/monitoring/time-series",[["integrationId","p",true]],1],["getAssociatedMonitoringEvents","get","/v2/integrations/{integrationId}/monitoring/events/{eventId}/associated",[["integrationId","p",true],["eventId","p",true]]],["ingestExternalMonitoringEvents","post","/v2/integrations/{integrationId}/monitoring/external-events",[["integrationId","p",true]],1],["getMonitoringTraceByCorrelation","get","/v2/integrations/{integrationId}/monitoring/traces/{correlationId}",[["integrationId","p",true],["correlationId","p",true]]],["listSecureProxies","get","/v1/integrations/secure-proxies"],["secureProxy","post","/v1/secure-proxy",null,1],["managedCallExecute","post","/v1/managed-call/{slug}/execute",[["slug","p",true]],1],["generateTypesPreview","post","/v1/integrations/{integrationId}/generate-types-preview",[["integrationId","p",true]]],["generateTypes","post","/v1/integrations/{integrationId}/generate-types",[["integrationId","p",true]],1],["commitTypes","post","/v1/integrations/{integrationId}/commit-types",[["integrationId","p",true]],1],["createErpImport","post","/v2/erp/imports",null,1],["listErpImports","get","/v2/erp/imports",[["limit","q"],["cursor","q"]]],["getErpImport","get","/v2/erp/imports/{importId}",[["importId","p",true]]],["deleteErpImport","delete","/v2/erp/imports/{importId}",[["importId","p",true]]],["validateErpImport","post","/v2/erp/imports/{importId}:validate",[["importId","p",true]],1],["suggestErpImportUseCases","post","/v2/erp/imports/{importId}:suggest-use-cases",[["importId","p",true]]],["executeErpImport","post","/v2/erp/imports/{importId}:execute",[["importId","p",true]],1],["abortErpImport","post","/v2/erp/imports/{importId}:abort",[["importId","p",true]]]],"v":"3.0.3"}

package/definitions/integration-toolkit.json

@@ -2,7 +2,7 @@
   "openapi": "3.0.3",
   "info": {
     "title": "Integration Toolkit API",
-    "version": "1.15.0",
+    "version": "1.17.0",
     "description": "API for integrating with external systems in a standardised way."
   },
   "tags": [
@@ -1628,6 +1628,239 @@
         }
       }
     },
+    "/v1/integrations/{integrationId}/documentation": {
+      "get": {
+        "operationId": "listDocumentationPages",
+        "summary": "listDocumentationPages",
+        "description": "Retrieve all documentation pages of an integration, without their markdown content.\nAn integration has at most one general page plus at most one page per use case.\nThe page id is 'general' for the integration-wide page, otherwise the use case ID.\n",
+        "tags": [
+          "integrations"
+        ],
+        "parameters": [
+          {
+            "name": "integrationId",
+            "in": "path",
+            "required": true,
+            "description": "The integration ID",
+            "schema": {
+              "type": "string",
+              "format": "uuid"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Successfully retrieved documentation pages",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "required": [
+                    "pages"
+                  ],
+                  "properties": {
+                    "pages": {
+                      "type": "array",
+                      "items": {
+                        "$ref": "#/components/schemas/DocumentationPageSummary"
+                      }
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "401": {
+            "$ref": "#/components/responses/Unauthorized"
+          },
+          "404": {
+            "description": "Integration not found"
+          },
+          "500": {
+            "$ref": "#/components/responses/InternalServerError"
+          }
+        }
+      }
+    },
+    "/v1/integrations/{integrationId}/documentation/{docId}": {
+      "get": {
+        "operationId": "getDocumentationPage",
+        "summary": "getDocumentationPage",
+        "description": "Retrieve a single documentation page including its markdown content",
+        "tags": [
+          "integrations"
+        ],
+        "parameters": [
+          {
+            "name": "integrationId",
+            "in": "path",
+            "required": true,
+            "description": "The integration ID",
+            "schema": {
+              "type": "string",
+              "format": "uuid"
+            }
+          },
+          {
+            "name": "docId",
+            "in": "path",
+            "required": true,
+            "description": "'general' for the integration-wide page, otherwise a use case ID",
+            "schema": {
+              "type": "string",
+              "pattern": "^(general|[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Successfully retrieved documentation page",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/DocumentationPage"
+                }
+              }
+            }
+          },
+          "401": {
+            "$ref": "#/components/responses/Unauthorized"
+          },
+          "404": {
+            "description": "Documentation page not found"
+          },
+          "500": {
+            "$ref": "#/components/responses/InternalServerError"
+          }
+        }
+      },
+      "put": {
+        "operationId": "upsertDocumentationPage",
+        "summary": "upsertDocumentationPage",
+        "description": "Create or update the documentation page identified by docId.\nUpsert semantics enforce the invariant of one general page per\nintegration and one page per use case. For use case pages the\nuse case must exist.\n",
+        "tags": [
+          "integrations"
+        ],
+        "parameters": [
+          {
+            "name": "integrationId",
+            "in": "path",
+            "required": true,
+            "description": "The integration ID",
+            "schema": {
+              "type": "string",
+              "format": "uuid"
+            }
+          },
+          {
+            "name": "docId",
+            "in": "path",
+            "required": true,
+            "description": "'general' for the integration-wide page, otherwise a use case ID",
+            "schema": {
+              "type": "string",
+              "pattern": "^(general|[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$"
+            }
+          }
+        ],
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/UpsertDocumentationPageRequest"
+              }
+            }
+          }
+        },
+        "responses": {
+          "200": {
+            "description": "Documentation page created or updated successfully",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/DocumentationPage"
+                }
+              }
+            }
+          },
+          "400": {
+            "$ref": "#/components/responses/BadRequest"
+          },
+          "401": {
+            "$ref": "#/components/responses/Unauthorized"
+          },
+          "403": {
+            "$ref": "#/components/responses/Forbidden"
+          },
+          "404": {
+            "description": "Integration or use case not found"
+          },
+          "500": {
+            "$ref": "#/components/responses/InternalServerError"
+          }
+        }
+      },
+      "delete": {
+        "operationId": "deleteDocumentationPage",
+        "summary": "deleteDocumentationPage",
+        "description": "Delete a documentation page",
+        "tags": [
+          "integrations"
+        ],
+        "parameters": [
+          {
+            "name": "integrationId",
+            "in": "path",
+            "required": true,
+            "description": "The integration ID",
+            "schema": {
+              "type": "string",
+              "format": "uuid"
+            }
+          },
+          {
+            "name": "docId",
+            "in": "path",
+            "required": true,
+            "description": "'general' for the integration-wide page, otherwise a use case ID",
+            "schema": {
+              "type": "string",
+              "pattern": "^(general|[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Documentation page deleted successfully",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "message": {
+                      "type": "string"
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "401": {
+            "$ref": "#/components/responses/Unauthorized"
+          },
+          "403": {
+            "$ref": "#/components/responses/Forbidden"
+          },
+          "404": {
+            "description": "Documentation page not found"
+          },
+          "500": {
+            "$ref": "#/components/responses/InternalServerError"
+          }
+        }
+      }
+    },
     "/v2/integrations": {
       "get": {
         "operationId": "listIntegrationsV2",
@@ -3879,6 +4112,38 @@
             "$ref": "#/components/responses/InternalServerError"
           }
         }
+      },
+      "delete": {
+        "operationId": "deleteErpImport",
+        "summary": "deleteErpImport",
+        "description": "Remove an import and the file it owns. Allowed from any status: an import whose run is still in flight is stopped by the deletion, and rows it already wrote stay written.",
+        "tags": [
+          "erp-imports"
+        ],
+        "parameters": [
+          {
+            "name": "importId",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          }
+        ],
+        "responses": {
+          "204": {
+            "description": "The import and its file were removed"
+          },
+          "403": {
+            "$ref": "#/components/responses/Forbidden"
+          },
+          "404": {
+            "$ref": "#/components/responses/NotFound"
+          },
+          "500": {
+            "$ref": "#/components/responses/InternalServerError"
+          }
+        }
       }
     },
     "/v2/erp/imports/{importId}:validate": {
@@ -4451,6 +4716,15 @@
           "s3_input_ref": {
             "$ref": "#/components/schemas/S3Reference"
           },
+          "size_bytes": {
+            "type": "integer",
+            "format": "int64",
+            "description": "Size of the uploaded file, recorded at registration. Present on every job registered from version 1.17.0 onwards; absent on older rows, which were written before it was captured."
+          },
+          "column_count": {
+            "type": "integer",
+            "description": "How many effective columns the file's header yielded — the length of the `preview.columns` returned at registration, kept so a job loaded later can still describe its file. The preview ROWS are deliberately not stored: they are a sample for the person about to choose a mapping, not job state. Present on every job registered from version 1.17.0 onwards."
+          },
           "validation": {
             "$ref": "#/components/schemas/ErpImportValidation"
           },
@@ -11029,6 +11303,110 @@
             }
           }
         }
+      },
+      "DocumentationPageSummary": {
+        "type": "object",
+        "description": "Documentation page metadata without the markdown content",
+        "required": [
+          "id",
+          "integration_id",
+          "scope",
+          "title",
+          "created_at",
+          "updated_at"
+        ],
+        "properties": {
+          "id": {
+            "type": "string",
+            "description": "'general' for the integration-wide page, otherwise the use case ID",
+            "example": "general"
+          },
+          "integration_id": {
+            "type": "string",
+            "format": "uuid",
+            "readOnly": true
+          },
+          "scope": {
+            "type": "string",
+            "enum": [
+              "integration",
+              "use_case"
+            ],
+            "description": "Whether the page documents the whole integration or a single use case"
+          },
+          "use_case_id": {
+            "type": "string",
+            "format": "uuid",
+            "description": "The linked use case. Only set when scope is use_case."
+          },
+          "title": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 150
+          },
+          "created_at": {
+            "type": "string",
+            "format": "date-time",
+            "readOnly": true
+          },
+          "created_by": {
+            "type": "string",
+            "nullable": true,
+            "description": "User ID that created the page",
+            "readOnly": true
+          },
+          "updated_at": {
+            "type": "string",
+            "format": "date-time",
+            "readOnly": true
+          },
+          "updated_by": {
+            "type": "string",
+            "nullable": true,
+            "description": "User ID of the last edit",
+            "readOnly": true
+          }
+        }
+      },
+      "DocumentationPage": {
+        "description": "A markdown documentation page of an integration",
+        "allOf": [
+          {
+            "$ref": "#/components/schemas/DocumentationPageSummary"
+          },
+          {
+            "type": "object",
+            "required": [
+              "content"
+            ],
+            "properties": {
+              "content": {
+                "type": "string",
+                "maxLength": 100000,
+                "description": "Markdown source of the page"
+              }
+            }
+          }
+        ]
+      },
+      "UpsertDocumentationPageRequest": {
+        "type": "object",
+        "required": [
+          "title",
+          "content"
+        ],
+        "properties": {
+          "title": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 150
+          },
+          "content": {
+            "type": "string",
+            "maxLength": 100000,
+            "description": "Markdown source of the page"
+          }
+        }
       }
     },
     "responses": {

package/definitions/message-runtime.json

@@ -1 +1 @@
-{"s":"https://message.sls.epilot.io","o":[["sendMessage","post","/v1/message/messages",[["do_not_create_entities","q"]],1],["updateMessage","put","/v1/message/messages"],["getMessage","get","/v1/message/messages/{id}",[["id","p",true]]],["deleteMessage","delete","/v1/message/messages/{id}",[["id","p",true]]],["getMessageEml","get","/v1/message/messages/{id}/eml",[["id","p",true]]],["searchMessages","post","/v1/message/messages:search",null,1],["trashMessage","post","/v1/message/messages/{id}/trash",[["id","p",true]]],["untrashMessage","post","/v1/message/messages/{id}/untrash",[["id","p",true]]],["markReadMessage","post","/v1/message/messages/{id}/read",[["id","p",true]]],["markReadMessageV2","post","/v2/message/messages/{id}/read",[["id","p",true]],1],["markUnreadMessage","post","/v1/message/messages/{id}/unread",[["id","p",true]]],["getUnread","get","/v1/message/messages/unread/{actor}",[["actor","p",true],["email_filter","q"]]],["markUnreadMessageV2","post","/v2/message/messages/{id}/unread",[["id","p",true]],1],["searchThreads","post","/v1/message/threads:search",null,1],["searchThreadsV2","post","/v2/message/threads:search",null,1],["searchIds","post","/v1/message/threads:searchIds",null,1],["getAssigneeWorkload","post","/v2/message/threads:workload",null,1],["updateThread","put","/v1/message/threads"],["deleteThread","delete","/v1/message/threads/{id}",[["id","p",true]]],["moveThread","post","/v1/message/threads/{id}:move",[["id","p",true]],1],["markThreadAsDone","post","/v1/message/threads/{id}:markAsDone",[["id","p",true]]],["markThreadAsOpen","post","/v1/message/threads/{id}:markAsOpen",[["id","p",true]]],["getThreadTimeline","get","/v1/message/threads/{id}/timeline",[["id","p",true]]],["trashThread","post","/v1/message/threads/{id}/trash",[["id","p",true]]],["untrashThread","post","/v1/message/threads/{id}/untrash",[["id","p",true]]],["spamThread","post","/v1/message/threads/{id}/spam",[["id","p",true]]],["unspamThread","post","/v1/message/threads/{id}/unspam",[["id","p",true]]],["spamMessage","post","/v1/message/messages/{id}/spam",[["id","p",true]]],["unspamMessage","post","/v1/message/messages/{id}/unspam",[["id","p",true]]],["bulkMoveThreads","post","/v1/message/threads/bulk:move",null,1],["bulkAssignThreads","post","/v1/message/threads/bulk:assign",null,1],["threadBulkActionsRead","post","/v1/message/threads/bulk:read",null,1],["threadBulkActionsUnread","post","/v1/message/threads/bulk:unread",null,1],["threadBulkActionsFavorite","post","/v1/message/threads/bulk:favorite",null,1],["threadBulkActionsUnfavorite","post","/v1/message/threads/bulk:unfavorite",null,1],["threadBulkActionsTrash","post","/v1/message/threads/bulk:trash",null,1],["threadBulkActionsUntrash","post","/v1/message/threads/bulk:untrash",null,1],["threadBulkActionsDelete","post","/v1/message/threads/bulk:delete",null,1],["threadBulkActionsDone","post","/v1/message/threads/bulk:done",null,1],["threadBulkActionsOpen","post","/v1/message/threads/bulk:open",null,1],["markReadThread","post","/v1/message/threads/{id}/read",[["id","p",true]]],["markReadThreadV2","post","/v2/message/threads/{id}/read",[["id","p",true]],1],["markUnreadThread","post","/v1/message/threads/{id}/unread",[["id","p",true]]],["markUnreadThreadV2","post","/v2/message/threads/{id}/unread",[["id","p",true]],1],["assignThread","post","/v1/message/threads/{id}/assign",[["id","p",true]],1],["unassignThread","post","/v1/message/threads/{id}/unassign",[["id","p",true],["unlink_mapped_entities","q"]],1],["assignUsers","post","/v1/message/threads/{id}/assign:users",[["id","p",true]],1],["assignUsersV2","post","/v2/message/threads/{id}/assign:users",[["id","p",true]],1],["pinThread","post","/v1/message/threads/{id}:pin",[["id","p",true]]],["unpinThread","delete","/v1/message/threads/{id}:pin",[["id","p",true]]],["createDraft","post","/v1/message/drafts",null,1],["sendDraft","post","/v1/message/drafts:send"],["getMessageV2","get","/v2/message/messages/{id}",[["id","p",true]]]]}
+{"s":"https://message.sls.epilot.io","o":[["sendMessage","post","/v1/message/messages",[["do_not_create_entities","q"]],1],["updateMessage","put","/v1/message/messages"],["getMessage","get","/v1/message/messages/{id}",[["id","p",true]]],["deleteMessage","delete","/v1/message/messages/{id}",[["id","p",true]]],["getMessageEml","get","/v1/message/messages/{id}/eml",[["id","p",true]]],["searchMessages","post","/v1/message/messages:search",null,1],["trashMessage","post","/v1/message/messages/{id}/trash",[["id","p",true]]],["untrashMessage","post","/v1/message/messages/{id}/untrash",[["id","p",true]]],["markReadMessage","post","/v1/message/messages/{id}/read",[["id","p",true]]],["markReadMessageV2","post","/v2/message/messages/{id}/read",[["id","p",true]],1],["markUnreadMessage","post","/v1/message/messages/{id}/unread",[["id","p",true]]],["getUnread","get","/v1/message/messages/unread/{actor}",[["actor","p",true],["email_filter","q"]]],["getUnreadCounts","post","/v1/message/unread:counts",null,1],["markUnreadMessageV2","post","/v2/message/messages/{id}/unread",[["id","p",true]],1],["searchThreads","post","/v1/message/threads:search",null,1],["searchThreadsV2","post","/v2/message/threads:search",null,1],["searchIds","post","/v1/message/threads:searchIds",null,1],["getAssigneeWorkload","post","/v2/message/threads:workload",null,1],["updateThread","put","/v1/message/threads"],["deleteThread","delete","/v1/message/threads/{id}",[["id","p",true]]],["moveThread","post","/v1/message/threads/{id}:move",[["id","p",true]],1],["markThreadAsDone","post","/v1/message/threads/{id}:markAsDone",[["id","p",true]]],["markThreadAsOpen","post","/v1/message/threads/{id}:markAsOpen",[["id","p",true]]],["getThreadTimeline","get","/v1/message/threads/{id}/timeline",[["id","p",true]]],["trashThread","post","/v1/message/threads/{id}/trash",[["id","p",true]]],["untrashThread","post","/v1/message/threads/{id}/untrash",[["id","p",true]]],["spamThread","post","/v1/message/threads/{id}/spam",[["id","p",true]]],["unspamThread","post","/v1/message/threads/{id}/unspam",[["id","p",true]]],["spamMessage","post","/v1/message/messages/{id}/spam",[["id","p",true]]],["unspamMessage","post","/v1/message/messages/{id}/unspam",[["id","p",true]]],["bulkMoveThreads","post","/v1/message/threads/bulk:move",null,1],["bulkAssignThreads","post","/v1/message/threads/bulk:assign",null,1],["threadBulkActionsRead","post","/v1/message/threads/bulk:read",null,1],["threadBulkActionsUnread","post","/v1/message/threads/bulk:unread",null,1],["threadBulkActionsFavorite","post","/v1/message/threads/bulk:favorite",null,1],["threadBulkActionsUnfavorite","post","/v1/message/threads/bulk:unfavorite",null,1],["threadBulkActionsTrash","post","/v1/message/threads/bulk:trash",null,1],["threadBulkActionsUntrash","post","/v1/message/threads/bulk:untrash",null,1],["threadBulkActionsDelete","post","/v1/message/threads/bulk:delete",null,1],["threadBulkActionsDone","post","/v1/message/threads/bulk:done",null,1],["threadBulkActionsOpen","post","/v1/message/threads/bulk:open",null,1],["markReadThread","post","/v1/message/threads/{id}/read",[["id","p",true]]],["markReadThreadV2","post","/v2/message/threads/{id}/read",[["id","p",true]],1],["markUnreadThread","post","/v1/message/threads/{id}/unread",[["id","p",true]]],["markUnreadThreadV2","post","/v2/message/threads/{id}/unread",[["id","p",true]],1],["assignThread","post","/v1/message/threads/{id}/assign",[["id","p",true]],1],["unassignThread","post","/v1/message/threads/{id}/unassign",[["id","p",true],["unlink_mapped_entities","q"]],1],["assignUsers","post","/v1/message/threads/{id}/assign:users",[["id","p",true]],1],["assignUsersV2","post","/v2/message/threads/{id}/assign:users",[["id","p",true]],1],["pinThread","post","/v1/message/threads/{id}:pin",[["id","p",true]]],["unpinThread","delete","/v1/message/threads/{id}:pin",[["id","p",true]]],["createDraft","post","/v1/message/drafts",null,1],["sendDraft","post","/v1/message/drafts:send"],["getMessageV2","get","/v2/message/messages/{id}",[["id","p",true]]]]}