fixes

Author: millotp

specs/ingestion/common/schemas/common.yml

@@ -6,11 +6,23 @@ updatedAt:
   type: string
   description: Date of last update (RFC3339 format).
 
+startedAt:
+  type: string
+  description: Date of start (RFC3339 format).
+
+finishedAt:
+  type: string
+  description: Date of finish (RFC3339 format).
+
+publishedAt:
+  type: string
+  description: Date of publish (RFC3339 format).
+
 DeleteResponse:
   type: object
   properties:
     deletedAt:
       type: string
-      description: Date of deletion (RFC3339 format)
+      description: Date of deletion (RFC3339 format).
   required:
     - deletedAt

specs/ingestion/paths/runs/events/eventID.yml

@@ -5,14 +5,14 @@ get:
   description: Get an event in a specific run.
   operationId: getEvent
   parameters:
-    - $ref: '../../common/parameters.yml#/runID'
-    - $ref: '../../common/parameters.yml#/eventID'
+    - $ref: '../../../common/parameters.yml#/runID'
+    - $ref: '../../../common/parameters.yml#/eventID'
   responses:
     '200':
       description: OK
       content:
         application/json:
           schema:
-            $ref: '../../common/schemas/event.yml#/Event'
+            $ref: '../../../common/schemas/event.yml#/Event'
     '400':
-      $ref: '../../../common/responses/BadRequest.yml'
+      $ref: '../../../../common/responses/BadRequest.yml'

specs/ingestion/paths/runs/events/events.yml

@@ -5,9 +5,9 @@ get:
   description: Get a list of events for a specific run.
   operationId: getEvents
   parameters:
-    - $ref: '../../common/parameters.yml#/runID'
-    - $ref: '../../common/parameters.yml#/itemsPerPage'
-    - $ref: '../../common/parameters.yml#/page'
+    - $ref: '../../../common/parameters.yml#/runID'
+    - $ref: '../../../common/parameters.yml#/itemsPerPage'
+    - $ref: '../../../common/parameters.yml#/page'
   responses:
     '200':
       description: OK
@@ -21,11 +21,11 @@ get:
               events:
                 type: array
                 items:
-                  $ref: '../../common/schemas/event.yml#/Event'
+                  $ref: '../../../common/schemas/event.yml#/Event'
               pagination:
-                $ref: '../../common/schemas/pagination.yml#/Pagination'
+                $ref: '../../../common/schemas/pagination.yml#/Pagination'
             required:
               - events
               - pagination
     '400':
-      $ref: '../../../common/responses/BadRequest.yml'
+      $ref: '../../../../common/responses/BadRequest.yml'

specs/ingestion/spec.yml

@@ -1,7 +1,7 @@
 openapi: 3.0.2
 info:
   title: Ingestion API
-  description: API powering the Data Ingestion feature of Algolia
+  description: API powering the Data Ingestion feature of Algolia.
   version: '1.0'
 components:
   securitySchemes:
@@ -26,15 +26,15 @@ tags:
   - name: destinations
     x-displayName: Destinations
     description: Destinations refers to an Algolia product (Search, Insight, Recommend, ...).
+  - name: observability
+    x-displayName: Observability
+    description: Observability api tracks each runs and events.
   - name: sources
     x-displayName: Sources
     description: Sources describe the platform informations.
   - name: tasks
     x-displayName: Tasks
     description: Tasks refers to all type of Ingestion we can do (Reindex, On demand update, ...).
-  - name: observability
-    x-displayName: Observability
-    description: Observability api tracks each runs and events
 paths:
   # authentications api
   /1/authentications: