docs(api): publish the current v1 public API spec

changelog/2026-08-26-browser-extension-1-0.mdx

@@ -1,8 +1,8 @@
 ---
-title: "Browser Extension 1.0.0 : Out of beta"
+title: "Browser Extension 1.0: Out of beta"
 description: "The Trunk browser extension graduates from beta with more reliable queue controls, clearer failure details, and groundwork for expanding Merge Queue beyond GitHub."
 slug: "browser-extension-1-0"
-date: "2026-08-26T00:00:00.000Z"
+date: "2026-08-26"
 category: "Merge Queue"
 type: "update"
 ---

docs.json

@@ -118,10 +118,13 @@
                     "pages": [
                       "POST /cancelPullRequest",
                       "POST /getSubmittedPullRequest",
+                      "POST /getSubmittedPullRequests",
+                      "POST /listPullRequests",
                       "POST /restartTestsOnPullRequest",
                       "POST /setImpactedTargets",
                       "POST /submitPullRequest",
-                      "POST /getMergeQueueTestingDetails"
+                      "POST /getMergeQueueTestingDetails",
+                      "POST /listMergeQueueTestingResults"
                     ]
                   },
                   {

merge-queue/reference/merge.mdx

@@ -17,8 +17,11 @@ All requests must be [authenticated](../../setup-and-administration/apis/#authen
 | [`/cancelPullRequest`](/merge-queue/reference/merge/cancel-a-pull-request-in-a-merge-queue) | POST | Remove a PR from the merge queue |
 | [`/restartTestsOnPullRequest`](/merge-queue/reference/merge/restart-tests-on-a-pull-request-in-a-merge-queue) | POST | Re-run tests on a PR currently in the queue |
 | [`/getSubmittedPullRequest`](/merge-queue/reference/merge/get-a-submitted-pull-request-from-a-merge-queue) | POST | Check the status of a submitted PR |
+| [`/getSubmittedPullRequests`](/merge-queue/reference/merge/get-several-submitted-pull-requests-from-a-merge-queue) | POST | Check the status of many submitted PRs at once |
+| [`/listPullRequests`](/merge-queue/reference/merge/list-pull-requests-in-a-merge-queue) | POST | List the PRs in a queue, filtered by state or concluded time range |
 | [`/setImpactedTargets`](/merge-queue/reference/merge/set-impacted-targets-for-a-pull-request) | POST | Set impacted targets for a PR (used with [parallel queues](../optimizations/parallel-queues/)) |
 | [`/getMergeQueueTestingDetails`](/merge-queue/reference/merge/get-details-about-testing-that-merge-queue-is-performing) | POST | Get details about in-progress merge queue testing |
+| [`/listMergeQueueTestingResults`](/merge-queue/reference/merge/list-completed-merge-queue-testing-for-a-time-range) | POST | List completed merge queue testing over a time range |
 | [`/createQueue`](/merge-queue/reference/merge/create-a-new-merge-queue) | POST | Create a new merge queue for a branch |
 | [`/deleteQueue`](/merge-queue/reference/merge/delete-the-specified-merge-queue-the-queue-must-be-empty-in-order-to-be-deleted) | POST | Delete an empty merge queue |
 | [`/getQueue`](/merge-queue/reference/merge/get-the-merge-queue) | POST | Get queue state, configuration, and enqueued PRs |
@@ -156,12 +159,22 @@ The response includes the queue state (`RUNNING`, `PAUSED`, `DRAINING`, or `SWIT
 <CardGroup cols={2}>
   <Card title="Cancel a pull request in a merge queue" href="/merge-queue/reference/merge/cancel-a-pull-request-in-a-merge-queue"/>
   <Card title="Get a submitted pull request from a merge queue" href="/merge-queue/reference/merge/get-a-submitted-pull-request-from-a-merge-queue"/>
+  <Card title="Get several submitted pull requests from a merge queue" href="/merge-queue/reference/merge/get-several-submitted-pull-requests-from-a-merge-queue"/>
+  <Card title="List pull requests in a merge queue" href="/merge-queue/reference/merge/list-pull-requests-in-a-merge-queue"/>
   <Card title="Restart tests on a pull request in a merge queue" href="/merge-queue/reference/merge/restart-tests-on-a-pull-request-in-a-merge-queue"/>
   <Card title="Set impacted targets for a pull request" href="/merge-queue/reference/merge/set-impacted-targets-for-a-pull-request"/>
   <Card title="Submit a pull request to a merge queue" href="/merge-queue/reference/merge/submit-a-pull-request-to-a-merge-queue"/>
   <Card title="Get details about testing that Merge Queue is performing" href="/merge-queue/reference/merge/get-details-about-testing-that-merge-queue-is-performing"/>
+  <Card title="List completed merge queue testing for a time range" href="/merge-queue/reference/merge/list-completed-merge-queue-testing-for-a-time-range"/>
 </CardGroup>
 
+Three endpoints read pull request state, and which one you want depends on whether you already know
+the pull requests you care about:
+
+* [`/getSubmittedPullRequest`](/merge-queue/reference/merge/get-a-submitted-pull-request-from-a-merge-queue) — one known PR, identified by number or head branch.
+* [`/getSubmittedPullRequests`](/merge-queue/reference/merge/get-several-submitted-pull-requests-from-a-merge-queue) — up to 50 known PRs in one request, with the same full record each: readiness, whether the PR is currently submitted, and optionally the timeline of every state change.
+* [`/listPullRequests`](/merge-queue/reference/merge/list-pull-requests-in-a-merge-queue) — discovery, when you don't know which PRs to ask about. Pages through the queue with a cursor and filters by state or by when PRs concluded, returning a summary row per PR rather than the full record.
+
 <Info>
 Large monorepos can produce target lists that exceed the 20 MiB request body limit. If you hit this limit, send `"ALL"` as the `impactedTargets` value to mark the PR as impacting every target.
 </Info>