openapi: internal operation failed endpoint

openapi-internal.yaml

@@ -121,6 +121,30 @@ paths:
             application/json:
               schema:
                 $ref: "#/components/schemas/Error"
+  /operations/{OperationID}/failed:
+    post:
+      summary: (Internal endpoint) Fail an operation and write a StatusMessage
+      operationId: actionOperationFailed
+      tags:
+        - Operations
+      parameters:
+        - $ref: '#/components/parameters/OperationID'
+        - name: StatusMessage
+          in: query
+          required: true
+          schema:
+            type: string
+            minLength: 0
+            maxLength: 4096
+      responses:
+        "204":
+          description: Successful response
+        default:
+          description: General Error
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/Error"
   /submissions:
     post:
       summary: Create a new submission
@@ -408,6 +432,14 @@ components:
       schema:
         type: integer
         format: int64
+    OperationID:
+      name: OperationID
+      in: path
+      required: true
+      description: The unique identifier for a long-running operation.
+      schema:
+        type: integer
+        format: int32
     SubmissionID:
       name: SubmissionID
       in: path