From 5a562a6a5c38e5d4b6e5549ad50443f2b0b4f2b6 Mon Sep 17 00:00:00 2001
From: Mahesh Vagicherla <maheshmahi19@outlook.com>
Date: Mon, 13 Jul 2026 09:22:01 +0530
Subject: [PATCH] chore: update get log route spec

---
 openapi.yaml | 29 +++++++++++++++++++++++++++++
 1 file changed, 29 insertions(+)

diff --git a/openapi.yaml b/openapi.yaml
index 8dd50b3d..0596e92e 100644
--- a/openapi.yaml
+++ b/openapi.yaml
@@ -16602,6 +16602,35 @@ paths:
           required: true
           schema:
             type: string
+        - name: path_format
+          in: query
+          required: false
+          description: >
+            Storage path format used to reconstruct the log file location.
+            Defaults to `v1`. When set to `v2`, `created_at` becomes required.
+          schema:
+            type: string
+            enum: [v1, v2]
+            default: v1
+        - name: created_at
+          in: query
+          required: false
+          description: >
+            ISO 8601 timestamp of when the log was created, used to reconstruct
+            the storage path. Required when `path_format=v2`.
+          schema:
+            type: string
+            format: date-time
+          example: "2026-07-13T09:17:00.000Z"
+        - name: type
+          in: query
+          required: false
+          description: >
+            Log type used to locate the correct storage path. Currently only
+            `hooks` is supported; omit for standard request logs.
+          schema:
+            type: string
+            enum: [hooks]
       responses:
         "200":
           description: Successful response