docs: document undocumented run API endpoints (#3120)

isshaddad · web-flow · commit 97bf89873eed · 2026-02-24T10:49:39.000-05:00
Adds API reference pages for three previously undocumented run
endpoints: retrieve run events, retrieve run trace, and add tags to a
run.
diff --git a/docs/docs.json b/docs/docs.json
@@ -253,7 +253,10 @@
               "management/runs/replay",
               "management/runs/cancel",
               "management/runs/reschedule",
-              "management/runs/update-metadata"
+              "management/runs/update-metadata",
+              "management/runs/add-tags",
+              "management/runs/retrieve-events",
+              "management/runs/retrieve-trace"
             ]
           },
           {
diff --git a/docs/management/runs/add-tags.mdx b/docs/management/runs/add-tags.mdx
@@ -0,0 +1,4 @@
+---
+title: "Add tags to a run"
+openapi: "v3-openapi POST /api/v1/runs/{runId}/tags"
+---
diff --git a/docs/management/runs/retrieve-events.mdx b/docs/management/runs/retrieve-events.mdx
@@ -0,0 +1,4 @@
+---
+title: "Retrieve run events"
+openapi: "v3-openapi GET /api/v1/runs/{runId}/events"
+---
diff --git a/docs/management/runs/retrieve-trace.mdx b/docs/management/runs/retrieve-trace.mdx
@@ -0,0 +1,4 @@
+---
+title: "Retrieve run trace"
+openapi: "v3-openapi GET /api/v1/runs/{runId}/trace"
+---
diff --git a/docs/v3-openapi.yaml b/docs/v3-openapi.yaml

Original file line number	Diff line number	Diff line change
`@@ -253,7 +253,10 @@`
`253`	`253`	`"management/runs/replay",`
`254`	`254`	`"management/runs/cancel",`
`255`	`255`	`"management/runs/reschedule",`
`256`		`- "management/runs/update-metadata"`
	`256`	`+ "management/runs/update-metadata",`
	`257`	`+ "management/runs/add-tags",`
	`258`	`+ "management/runs/retrieve-events",`
	`259`	`+ "management/runs/retrieve-trace"`
`257`	`260`	`]`
`258`	`261`	`},`
`259`	`262`	`{`
-Original file line number
+Diff line change
@@ @@ -0,0 +1,4 @@ @@
 +---
 +title: "Add tags to a run"
 +openapi: "v3-openapi POST /api/v1/runs/{runId}/tags"
 +---