Add documentation for /events/id endpoint

wellcomecollection · Nov 15, 2024 · 0aab73a · 0aab73a
1 parent 7254a34
commit 0aab73a
Showing 1 changed file with 45 additions and 1 deletion.
diff --git a/reference/content.yaml b/reference/content.yaml
@@ -278,7 +278,51 @@ paths:
             '*/*':
               schema:
                 $ref: '#/components/schemas/Error'
-  # '/events/{id}':
+  '/events/{id}':
+    get:
+      tags:
+        - Events
+      summary: '/events/{id}'
+      description: Returns a single event
+      operationId: getEvent
+      parameters:
+        - name: id
+          in: path
+          description: The event to return
+          required: true
+          schema:
+            type: string
+      responses:
+        '200':
+          description: The event
+          content:
+            '*/*':
+              schema:
+                $ref: '#/components/schemas/Event'
+        '400':
+          description: Bad Request Error
+          content:
+            '*/*':
+              schema:
+                $ref: '#/components/schemas/Error'
+        '404':
+          description: Not Found Error
+          content:
+            '*/*':
+              schema:
+                $ref: '#/components/schemas/Error'
+        '410':
+          description: Gone Error
+          content:
+            '*/*':
+              schema:
+                $ref: '#/components/schemas/Error'
+        '500':
+          description: Internal Server Error
+          content:
+            '*/*':
+              schema:
+                $ref: '#/components/schemas/Error'
 components:
   schemas:
     Aggregation: