From d75d251b7b11a7106a906cdf2656dcd5435f66ed Mon Sep 17 00:00:00 2001
From: Zach Handley <zach@blackleafdigital.com>
Date: Tue, 26 May 2026 10:50:15 -0700
Subject: [PATCH] Regen swagger

---
 templates/swagger/v1_json.tmpl | 19 +++++++++++++++++--
 1 file changed, 17 insertions(+), 2 deletions(-)

diff --git a/templates/swagger/v1_json.tmpl b/templates/swagger/v1_json.tmpl
index 61bf31ccbe..5e31bf1cd5 100644
--- a/templates/swagger/v1_json.tmpl
+++ b/templates/swagger/v1_json.tmpl
@@ -5812,6 +5812,7 @@
     },
     "/repos/{owner}/{repo}/actions/jobs/{job_id}/logs": {
       "get": {
+        "description": "Returns the plaintext log for the job. By default the log for the\nmost recent attempt is returned (ActionRunJob.TaskID tracks the latest\ntask). Pass `?attempt=N` to fetch the log for a specific historical\nattempt; the value matches the `attempt` field returned by the job\nlisting endpoints.\n",
         "produces": [
           "text/plain"
         ],
@@ -5838,11 +5839,18 @@
           {
             "type": "integer",
             "format": "int64",
-            "description": "id of the action job",
+            "description": "ID of the workflow job",
             "name": "job_id",
             "in": "path",
             "required": true
           },
+          {
+            "type": "integer",
+            "format": "int64",
+            "description": "1-based attempt number matching the value of `attempt` in the job listing; omit to fetch the latest attempt of the job",
+            "name": "attempt",
+            "in": "query"
+          },
           {
             "type": "integer",
             "description": "0-indexed step to filter to (returns only that step's portion of the log)",
@@ -6498,10 +6506,17 @@
           {
             "type": "integer",
             "format": "int64",
-            "description": "id of the action run",
+            "description": "ID of the workflow run. The ZIP contains logs for the latest attempt\nof each job in the run, with each entry named `{job-name}-{job-id}.log`\n(the job ID prevents collisions when two jobs share a name).\n",
             "name": "run_id",
             "in": "path",
             "required": true
+          },
+          {
+            "type": "integer",
+            "format": "int64",
+            "description": "1-based attempt number; omit to fetch the latest attempt of each job. Jobs that don't have that attempt recorded contribute a `.MISSING` placeholder entry instead of a `.log`.",
+            "name": "attempt",
+            "in": "query"
           }
         ],
         "responses": {