added callback specs

Author: sgalpha01

openapi/task_execution_service.openapi.yaml

@@ -151,7 +151,7 @@ paths:
           '{$request.body#/callback_url}':
             post:
               description: |-
-                The API will send notifications to the callback URL, if provided,
+                The TES server will send notifications to the callback URL, if provided,
                 when the task status changes.
               requestBody:
                 content:
@@ -236,6 +236,19 @@ components:
         - FULL
 
   schemas:
+    tesCallbackStatus:
+      type: object
+      required:
+      - id
+      - state
+      properties:
+        id:
+          type: string
+          description: Task identifier assigned by the server.
+          example: job-0012345
+        state:
+          $ref: '#/components/schemas/tesState'
+      description: Notification that a task has changed state.
     tesCancelTaskResponse:
       type: object
       description: CancelTaskResponse describes a response from the CancelTask endpoint.
@@ -675,9 +688,7 @@ components:
           type: string
           format: uri
           description: |-
-            Optional user-provided callback URL. Note that the URL can be
-            provided while creating a new task, but it MUST NOT be displayed when
-            a task or a list of tasks is returned by the TES server.
+            Optional user-provided callback URL.
           example: https://myserver.com/send/callback/here
         inputs:
           type: array
@@ -765,20 +776,7 @@ components:
             This is set by the system, not the client.
           example: 2020-10-02T10:00:00-05:00
           readOnly: true
-      description: Task describes an instance of a task.
-    tesCallbackStatus:
-      type: object
-      required:
-      - task_id
-      - state
-      properties:
-        task_id:
-          type: string
-          description: Task identifier assigned by the server.
-          example: job-0012345
-        state:
-          $ref: '#/components/schemas/tesState'
-      description: Notification that a task has changed state.     
+      description: Task describes an instance of a task.    
     tesTaskLog:
       required:
       - logs