@browserless.io/browserless 2.29.0 → 2.30.0

package/static/docs/swagger.min.json

@@ -280,14 +280,14 @@
                 "length": {
                   "type": "number"
                 },
-                "__@toStringTag@118534": {
+                "__@toStringTag@14939": {
                   "type": "string",
                   "const": "Uint8Array"
                 }
               },
               "required": [
                 "BYTES_PER_ELEMENT",
-                "__@toStringTag@118534",
+                "__@toStringTag@14939",
                 "buffer",
                 "byteLength",
                 "byteOffset",
@@ -322,13 +322,13 @@
         "byteLength": {
           "type": "number"
         },
-        "__@toStringTag@118534": {
+        "__@toStringTag@14939": {
           "type": "string"
         }
       },
       "additionalProperties": false,
       "required": [
-        "__@toStringTag@118534",
+        "__@toStringTag@14939",
         "byteLength"
       ]
     },
@@ -338,18 +338,18 @@
         "byteLength": {
           "type": "number"
         },
-        "__@species@118572": {
+        "__@species@14977": {
           "$ref": "#/definitions/SharedArrayBuffer"
         },
-        "__@toStringTag@118534": {
+        "__@toStringTag@14939": {
           "type": "string",
           "const": "SharedArrayBuffer"
         }
       },
       "additionalProperties": false,
       "required": [
-        "__@species@118572",
-        "__@toStringTag@118534",
+        "__@species@14977",
+        "__@toStringTag@14939",
         "byteLength"
       ]
     },
@@ -1001,7 +1001,7 @@
   },
   "info": {
     "title": "Browserless",
-    "version": "2.29.0",
+    "version": "2.30.0",
     "x-logo": {
       "altText": "browserless logo",
       "url": "./docs/browserless-logo-inline.svg"
@@ -3256,10 +3256,10 @@
         ]
       }
     },
-    "/devtools/browser/*": {
-      "get": {
+    "/content /chromium/content": {
+      "post": {
         "definitions": {},
-        "description": "Connect to an already-running Chromium process with a library like\npuppeteer, or others, that work over chrome-devtools-protocol. Chromium\nmust already be launched in order to not return a 404.",
+        "description": "A JSON-based API. Given a \"url\" or \"html\" field, runs and returns HTML content after the page has loaded and JavaScript has parsed.",
         "parameters": [
           {
             "in": "query",
@@ -3273,7 +3273,6 @@
             "in": "query",
             "name": "launch",
             "schema": {
-              "description": "Launch options, which can be either an object\nof puppeteer.launch options or playwright.launchServer\noptions, depending on the API. Must be either JSON\nobject, or a base64-encoded JSON object.",
               "anyOf": [
                 {
                   "$ref": "#/definitions/CDPLaunchOptions"
@@ -3310,11 +3309,208 @@
           }
         ],
         "requestBody": {
-          "content": {}
+          "content": {
+            "application/json": {
+              "schema": {
+                "properties": {
+                  "addScriptTag": {
+                    "type": "array",
+                    "items": {
+                      "$ref": "#/definitions/FrameAddScriptTagOptions"
+                    }
+                  },
+                  "addStyleTag": {
+                    "type": "array",
+                    "items": {
+                      "$ref": "#/definitions/FrameAddStyleTagOptions"
+                    }
+                  },
+                  "authenticate": {
+                    "anyOf": [
+                      {
+                        "$ref": "#/definitions/Credentials"
+                      },
+                      {
+                        "type": "null"
+                      }
+                    ]
+                  },
+                  "bestAttempt": {
+                    "description": "When bestAttempt is set to true, browserless attempt to proceed\nwhen \"awaited\" events fail or timeout. This includes things like\ngoto, waitForSelector, and more.",
+                    "type": "boolean"
+                  },
+                  "cookies": {
+                    "type": "array",
+                    "items": {
+                      "$ref": "#/definitions/CookieParam"
+                    }
+                  },
+                  "emulateMediaType": {
+                    "type": "string"
+                  },
+                  "gotoOptions": {
+                    "$ref": "#/definitions/GoToOptions"
+                  },
+                  "html": {
+                    "type": "string"
+                  },
+                  "rejectRequestPattern": {
+                    "type": "array",
+                    "items": {
+                      "type": "string"
+                    }
+                  },
+                  "rejectResourceTypes": {
+                    "type": "array",
+                    "items": {
+                      "enum": [
+                        "cspviolationreport",
+                        "document",
+                        "eventsource",
+                        "fetch",
+                        "font",
+                        "image",
+                        "manifest",
+                        "media",
+                        "other",
+                        "ping",
+                        "prefetch",
+                        "preflight",
+                        "script",
+                        "signedexchange",
+                        "stylesheet",
+                        "texttrack",
+                        "websocket",
+                        "xhr"
+                      ],
+                      "type": "string"
+                    }
+                  },
+                  "requestInterceptors": {
+                    "type": "array",
+                    "items": {
+                      "description": "An array of patterns (using `req.url().match(r.pattern)` to match) and their\ncorresponding responses to use in order to fulfill those requests.",
+                      "type": "object",
+                      "properties": {
+                        "pattern": {
+                          "description": "An array of patterns (using `req.url().match(r.pattern)` to match) and their\ncorresponding responses to use in order to fulfill those requests.",
+                          "type": "string"
+                        },
+                        "response": {
+                          "$ref": "#/definitions/Partial<ResponseForRequest>"
+                        }
+                      },
+                      "additionalProperties": false,
+                      "required": [
+                        "pattern",
+                        "response"
+                      ]
+                    }
+                  },
+                  "setExtraHTTPHeaders": {
+                    "$ref": "#/definitions/Record<string,string>"
+                  },
+                  "setJavaScriptEnabled": {
+                    "description": "Whether or not to allow JavaScript to run on the page.",
+                    "type": "boolean"
+                  },
+                  "url": {
+                    "type": "string"
+                  },
+                  "userAgent": {
+                    "type": "string"
+                  },
+                  "viewport": {
+                    "anyOf": [
+                      {
+                        "$ref": "#/definitions/Viewport"
+                      },
+                      {
+                        "type": "null"
+                      }
+                    ]
+                  },
+                  "waitForEvent": {
+                    "type": "object",
+                    "properties": {
+                      "event": {
+                        "type": "string"
+                      },
+                      "timeout": {
+                        "type": "number"
+                      }
+                    },
+                    "additionalProperties": false,
+                    "required": [
+                      "event"
+                    ]
+                  },
+                  "waitForFunction": {
+                    "type": "object",
+                    "properties": {
+                      "fn": {
+                        "description": "The function, or statement, to be evaluated in browser context",
+                        "type": "string"
+                      },
+                      "polling": {
+                        "description": "An interval at which the pageFunction is executed, defaults to raf.\nIf polling is a number, then it is treated as an interval in milliseconds\nat which the function would be executed. If polling is a string,\nthen it can be one of the following values: \"raf\" or \"mutation\"",
+                        "type": [
+                          "string",
+                          "number"
+                        ]
+                      },
+                      "timeout": {
+                        "description": "Maximum time to wait for in milliseconds. Defaults to 30000 (30 seconds).\nPass 0 to disable timeout.",
+                        "type": "number"
+                      }
+                    },
+                    "additionalProperties": false,
+                    "required": [
+                      "fn"
+                    ]
+                  },
+                  "waitForSelector": {
+                    "type": "object",
+                    "properties": {
+                      "hidden": {
+                        "type": "boolean"
+                      },
+                      "selector": {
+                        "type": "string"
+                      },
+                      "timeout": {
+                        "type": "number"
+                      },
+                      "visible": {
+                        "type": "boolean"
+                      }
+                    },
+                    "additionalProperties": false,
+                    "required": [
+                      "selector"
+                    ]
+                  },
+                  "waitForTimeout": {
+                    "type": "number"
+                  }
+                },
+                "type": "object"
+              }
+            }
+          }
         },
         "responses": {
-          "101": {
-            "description": "Indicates successful WebSocket upgrade."
+          "200": {
+            "content": {
+              "text/html": {
+                "schema": {
+                  "description": "An HTML payload of the website or HTML after JavaScript\nparsing and execution.",
+                  "type": "string",
+                  "$schema": "http://json-schema.org/draft-07/schema#"
+                }
+              }
+            },
+            "description": "An HTML payload of the website or HTML after JavaScript\nparsing and execution."
           },
           "400": {
             "code": 400,
@@ -3347,16 +3543,16 @@
             "message": "HTTP/1.1 500 Internal Server Error"
           }
         },
-        "summary": "/devtools/browser/*",
+        "summary": "/content /chromium/content",
         "tags": [
-          "Browser WebSocket APIs"
+          "Browser REST APIs"
         ]
       }
     },
-    "/chrome": {
-      "get": {
+    "/download /chromium/download": {
+      "post": {
         "definitions": {},
-        "description": "Launch and connect to Chromium with a library like puppeteer or others that work over chrome-devtools-protocol.",
+        "description": "A JSON or JavaScript content-type API for returning files Chrome has downloaded during\nthe execution of puppeteer code, which is ran inside context of the browser.\nBrowserless sets up a blank page, a fresh download directory, injects your puppeteer code, and then executes it.\nYou can load external libraries via the \"import\" syntax, and import ESM-style modules\nthat are written for execution inside of the browser. Once your script is finished, any\ndownloaded files from Chromium are returned back with the appropriate content-type header.",
         "parameters": [
           {
             "in": "query",
@@ -3407,11 +3603,30 @@
           }
         ],
         "requestBody": {
-          "content": {}
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/definitions/JSONSchema"
+              }
+            },
+            "application/javascript": {
+              "schema": {
+                "type": "string"
+              }
+            }
+          }
         },
         "responses": {
-          "101": {
-            "description": "Indicates successful WebSocket upgrade."
+          "200": {
+            "content": {
+              "*/*": {
+                "schema": {
+                  "description": "Responses are determined by the returned value of the downloads\nthemselves, so there isn't a static response type for this API.",
+                  "$schema": "http://json-schema.org/draft-07/schema#"
+                }
+              }
+            },
+            "description": "Responses are determined by the returned value of the downloads\nthemselves, so there isn't a static response type for this API."
           },
           "400": {
             "code": 400,
@@ -3444,16 +3659,16 @@
             "message": "HTTP/1.1 500 Internal Server Error"
           }
         },
-        "summary": "/chrome",
+        "summary": "/download /chromium/download",
         "tags": [
-          "Browser WebSocket APIs"
+          "Browser REST APIs"
         ]
       }
     },
-    "/devtools/page/*": {
-      "get": {
+    "/function /chromium/function": {
+      "post": {
         "definitions": {},
-        "description": "Connect to an existing page in Chromium with a library like\nchrome-remote-interface or others that work the page websocketDebugger\nURL. You can get this unique URL by calling the /json/list API\nor by finding the page's unique ID from your library of choice.",
+        "description": "A JSON or JavaScript content-type API for running puppeteer code in the browser's context.\nBrowserless sets up a blank page, injects your puppeteer code, and runs it.\nYou can optionally load external libraries via the \"import\" module that are meant for browser usage.\nValues returned from the function are checked and an appropriate content-type and response is sent back\nto your HTTP call.",
         "parameters": [
           {
             "in": "query",
@@ -3504,108 +3719,30 @@
           }
         ],
         "requestBody": {
-          "content": {}
-        },
-        "responses": {
-          "101": {
-            "description": "Indicates successful WebSocket upgrade."
-          },
-          "400": {
-            "code": 400,
-            "description": "The request contains errors or didn't properly encode content.",
-            "message": "HTTP/1.1 400 Bad Request"
-          },
-          "401": {
-            "code": 401,
-            "description": "The request is missing, or contains bad, authorization credentials.",
-            "message": "HTTP/1.1 401 Unauthorized"
-          },
-          "404": {
-            "code": 404,
-            "description": "Resource couldn't be found.",
-            "message": "HTTP/1.1 404 Not Found"
-          },
-          "408": {
-            "code": 408,
-            "description": "The request took has taken too long to process.",
-            "message": "HTTP/1.1 408 Request Timeout"
-          },
-          "429": {
-            "code": 429,
-            "description": "Too many requests are currently being processed.",
-            "message": "HTTP/1.1 429 Too Many Requests"
-          },
-          "500": {
-            "code": 500,
-            "description": "An internal error occurred when handling the request.",
-            "message": "HTTP/1.1 500 Internal Server Error"
-          }
-        },
-        "summary": "/devtools/page/*",
-        "tags": [
-          "Browser WebSocket APIs"
-        ]
-      }
-    },
-    "/chrome/playwright": {
-      "get": {
-        "definitions": {},
-        "description": "Connect to Chromium with any playwright style library.",
-        "parameters": [
-          {
-            "in": "query",
-            "name": "blockAds",
-            "schema": {
-              "description": "Whether or nor to load ad-blocking extensions for the session.\nThis currently uses uBlock-Lite and may cause certain sites\nto not load properly.",
-              "type": "boolean"
-            }
-          },
-          {
-            "in": "query",
-            "name": "launch",
-            "schema": {
-              "description": "Launch options, which can be either an object\nof puppeteer.launch options or playwright.launchServer\noptions, depending on the API. Must be either JSON\nobject, or a base64-encoded JSON object.",
-              "anyOf": [
-                {
-                  "$ref": "#/definitions/BrowserServerOptions"
-                },
-                {
-                  "type": "string"
-                }
-              ]
-            }
-          },
-          {
-            "in": "query",
-            "name": "timeout",
-            "schema": {
-              "description": "Override the system-level timeout for this request.\nAccepts a value in milliseconds.",
-              "type": "number"
-            }
-          },
-          {
-            "in": "query",
-            "name": "token",
-            "schema": {
-              "description": "The authorization token",
-              "type": "string"
-            }
-          },
-          {
-            "in": "query",
-            "name": "trackingId",
-            "schema": {
-              "description": "Custom session identifier",
-              "type": "string"
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/definitions/JSONSchema"
+              }
+            },
+            "application/javascript": {
+              "schema": {
+                "type": "string"
+              }
             }
           }
-        ],
-        "requestBody": {
-          "content": {}
         },
         "responses": {
-          "101": {
-            "description": "Indicates successful WebSocket upgrade."
+          "200": {
+            "content": {
+              "*/*": {
+                "schema": {
+                  "description": "Responses are determined by the returned value of the function\nitself. Binary responses (PDF's, screenshots) are returned back\nas binary data, and primitive JavaScript values are returned back\nby type (HTML data is \"text/html\", Objects are \"application/json\")",
+                  "$schema": "http://json-schema.org/draft-07/schema#"
+                }
+              }
+            },
+            "description": "Responses are determined by the returned value of the function\nitself. Binary responses (PDF's, screenshots) are returned back\nas binary data, and primitive JavaScript values are returned back\nby type (HTML data is \"text/html\", Objects are \"application/json\")"
           },
           "400": {
             "code": 400,
@@ -3638,16 +3775,16 @@
             "message": "HTTP/1.1 500 Internal Server Error"
           }
         },
-        "summary": "/chrome/playwright",
+        "summary": "/function /chromium/function",
         "tags": [
-          "Browser WebSocket APIs"
+          "Browser REST APIs"
         ]
       }
     },
-    "/content /chromium/content": {
+    "/pdf /chromium/pdf": {
       "post": {
         "definitions": {},
-        "description": "A JSON-based API. Given a \"url\" or \"html\" field, runs and returns HTML content after the page has loaded and JavaScript has parsed.",
+        "description": "A JSON-based API for getting a PDF binary from either a supplied\n\"url\" or \"html\" payload in your request. Many options exist for\ninjecting cookies, request interceptors, user-agents and waiting for\nselectors, timers and more.",
         "parameters": [
           {
             "in": "query",
@@ -3661,6 +3798,7 @@
             "in": "query",
             "name": "launch",
             "schema": {
+              "description": "Launch options, which can be either an object\nof puppeteer.launch options or playwright.launchServer\noptions, depending on the API. Must be either JSON\nobject, or a base64-encoded JSON object.",
               "anyOf": [
                 {
                   "$ref": "#/definitions/CDPLaunchOptions"
@@ -3742,6 +3880,9 @@
                   "html": {
                     "type": "string"
                   },
+                  "options": {
+                    "$ref": "#/definitions/PDFOptions"
+                  },
                   "rejectRequestPattern": {
                     "type": "array",
                     "items": {
@@ -3799,7 +3940,6 @@
                     "$ref": "#/definitions/Record<string,string>"
                   },
                   "setJavaScriptEnabled": {
-                    "description": "Whether or not to allow JavaScript to run on the page.",
                     "type": "boolean"
                   },
                   "url": {
@@ -3890,15 +4030,15 @@
         "responses": {
           "200": {
             "content": {
-              "text/html": {
+              "application/pdf": {
                 "schema": {
-                  "description": "An HTML payload of the website or HTML after JavaScript\nparsing and execution.",
+                  "description": "Responds with an application/pdf content-type and a binary PDF",
                   "type": "string",
                   "$schema": "http://json-schema.org/draft-07/schema#"
                 }
               }
             },
-            "description": "An HTML payload of the website or HTML after JavaScript\nparsing and execution."
+            "description": "Responds with an application/pdf content-type and a binary PDF"
           },
           "400": {
             "code": 400,
@@ -3931,16 +4071,16 @@
             "message": "HTTP/1.1 500 Internal Server Error"
           }
         },
-        "summary": "/content /chromium/content",
+        "summary": "/pdf /chromium/pdf",
         "tags": [
           "Browser REST APIs"
         ]
       }
     },
-    "/download /chromium/download": {
+    "/performance /chromium/performance": {
       "post": {
         "definitions": {},
-        "description": "A JSON or JavaScript content-type API for returning files Chrome has downloaded during\nthe execution of puppeteer code, which is ran inside context of the browser.\nBrowserless sets up a blank page, a fresh download directory, injects your puppeteer code, and then executes it.\nYou can load external libraries via the \"import\" syntax, and import ESM-style modules\nthat are written for execution inside of the browser. Once your script is finished, any\ndownloaded files from Chromium are returned back with the appropriate content-type header.",
+        "description": "Run lighthouse performance audits with a supplied \"url\" in your JSON payload.",
         "parameters": [
           {
             "in": "query",
@@ -3994,12 +4134,25 @@
           "content": {
             "application/json": {
               "schema": {
-                "$ref": "#/definitions/JSONSchema"
-              }
-            },
-            "application/javascript": {
-              "schema": {
-                "type": "string"
+                "properties": {
+                  "budgets": {
+                    "type": "array",
+                    "items": {
+                      "type": "object",
+                      "properties": {},
+                      "additionalProperties": true
+                    }
+                  },
+                  "config": {
+                    "type": "object",
+                    "properties": {},
+                    "additionalProperties": true
+                  },
+                  "url": {
+                    "type": "string"
+                  }
+                },
+                "type": "object"
               }
             }
           }
@@ -4007,14 +4160,17 @@
         "responses": {
           "200": {
             "content": {
-              "*/*": {
+              "application/json": {
                 "schema": {
-                  "description": "Responses are determined by the returned value of the downloads\nthemselves, so there isn't a static response type for this API.",
+                  "description": "The response of the lighthouse stats. Response objects are\ndetermined by the type of budgets and config in the POST\nJSON body",
+                  "type": "object",
+                  "properties": {},
+                  "additionalProperties": true,
                   "$schema": "http://json-schema.org/draft-07/schema#"
                 }
               }
             },
-            "description": "Responses are determined by the returned value of the downloads\nthemselves, so there isn't a static response type for this API."
+            "description": "The response of the lighthouse stats. Response objects are\ndetermined by the type of budgets and config in the POST\nJSON body"
           },
           "400": {
             "code": 400,
@@ -4047,16 +4203,16 @@
             "message": "HTTP/1.1 500 Internal Server Error"
           }
         },
-        "summary": "/download /chromium/download",
+        "summary": "/performance /chromium/performance",
         "tags": [
           "Browser REST APIs"
         ]
       }
     },
-    "/function /chromium/function": {
+    "/scrape /chromium/scrape": {
       "post": {
         "definitions": {},
-        "description": "A JSON or JavaScript content-type API for running puppeteer code in the browser's context.\nBrowserless sets up a blank page, injects your puppeteer code, and runs it.\nYou can optionally load external libraries via the \"import\" module that are meant for browser usage.\nValues returned from the function are checked and an appropriate content-type and response is sent back\nto your HTTP call.",
+        "description": "A JSON-based API that returns text, html, and meta-data from a given list of selectors.\nDebugging information is available by sending in the appropriate flags in the \"debugOpts\"\nproperty. Responds with an array of JSON objects.",
         "parameters": [
           {
             "in": "query",
@@ -4070,123 +4226,6 @@
             "in": "query",
             "name": "launch",
             "schema": {
-              "description": "Launch options, which can be either an object\nof puppeteer.launch options or playwright.launchServer\noptions, depending on the API. Must be either JSON\nobject, or a base64-encoded JSON object.",
-              "anyOf": [
-                {
-                  "$ref": "#/definitions/CDPLaunchOptions"
-                },
-                {
-                  "type": "string"
-                }
-              ]
-            }
-          },
-          {
-            "in": "query",
-            "name": "timeout",
-            "schema": {
-              "description": "Override the system-level timeout for this request.\nAccepts a value in milliseconds.",
-              "type": "number"
-            }
-          },
-          {
-            "in": "query",
-            "name": "token",
-            "schema": {
-              "description": "The authorization token",
-              "type": "string"
-            }
-          },
-          {
-            "in": "query",
-            "name": "trackingId",
-            "schema": {
-              "description": "Custom session identifier",
-              "type": "string"
-            }
-          }
-        ],
-        "requestBody": {
-          "content": {
-            "application/json": {
-              "schema": {
-                "$ref": "#/definitions/JSONSchema"
-              }
-            },
-            "application/javascript": {
-              "schema": {
-                "type": "string"
-              }
-            }
-          }
-        },
-        "responses": {
-          "200": {
-            "content": {
-              "*/*": {
-                "schema": {
-                  "description": "Responses are determined by the returned value of the function\nitself. Binary responses (PDF's, screenshots) are returned back\nas binary data, and primitive JavaScript values are returned back\nby type (HTML data is \"text/html\", Objects are \"application/json\")",
-                  "$schema": "http://json-schema.org/draft-07/schema#"
-                }
-              }
-            },
-            "description": "Responses are determined by the returned value of the function\nitself. Binary responses (PDF's, screenshots) are returned back\nas binary data, and primitive JavaScript values are returned back\nby type (HTML data is \"text/html\", Objects are \"application/json\")"
-          },
-          "400": {
-            "code": 400,
-            "description": "The request contains errors or didn't properly encode content.",
-            "message": "HTTP/1.1 400 Bad Request"
-          },
-          "401": {
-            "code": 401,
-            "description": "The request is missing, or contains bad, authorization credentials.",
-            "message": "HTTP/1.1 401 Unauthorized"
-          },
-          "404": {
-            "code": 404,
-            "description": "Resource couldn't be found.",
-            "message": "HTTP/1.1 404 Not Found"
-          },
-          "408": {
-            "code": 408,
-            "description": "The request took has taken too long to process.",
-            "message": "HTTP/1.1 408 Request Timeout"
-          },
-          "429": {
-            "code": 429,
-            "description": "Too many requests are currently being processed.",
-            "message": "HTTP/1.1 429 Too Many Requests"
-          },
-          "500": {
-            "code": 500,
-            "description": "An internal error occurred when handling the request.",
-            "message": "HTTP/1.1 500 Internal Server Error"
-          }
-        },
-        "summary": "/function /chromium/function",
-        "tags": [
-          "Browser REST APIs"
-        ]
-      }
-    },
-    "/pdf /chromium/pdf": {
-      "post": {
-        "definitions": {},
-        "description": "A JSON-based API for getting a PDF binary from either a supplied\n\"url\" or \"html\" payload in your request. Many options exist for\ninjecting cookies, request interceptors, user-agents and waiting for\nselectors, timers and more.",
-        "parameters": [
-          {
-            "in": "query",
-            "name": "blockAds",
-            "schema": {
-              "description": "Whether or nor to load ad-blocking extensions for the session.\nThis currently uses uBlock-Lite and may cause certain sites\nto not load properly.",
-              "type": "boolean"
-            }
-          },
-          {
-            "in": "query",
-            "name": "launch",
-            "schema": {
-              "description": "Launch options, which can be either an object\nof puppeteer.launch options or playwright.launchServer\noptions, depending on the API. Must be either JSON\nobject, or a base64-encoded JSON object.",
               "anyOf": [
                 {
                   "$ref": "#/definitions/CDPLaunchOptions"
@@ -4259,6 +4298,15 @@
                       "$ref": "#/definitions/CookieParam"
                     }
                   },
+                  "debugOpts": {
+                    "$ref": "#/definitions/ScrapeDebugOptions"
+                  },
+                  "elements": {
+                    "type": "array",
+                    "items": {
+                      "$ref": "#/definitions/ScrapeElementSelector"
+                    }
+                  },
                   "emulateMediaType": {
                     "type": "string"
                   },
@@ -4268,9 +4316,6 @@
                   "html": {
                     "type": "string"
                   },
-                  "options": {
-                    "$ref": "#/definitions/PDFOptions"
-                  },
                   "rejectRequestPattern": {
                     "type": "array",
                     "items": {
@@ -4415,445 +4460,12 @@
             }
           }
         },
-        "responses": {
-          "200": {
-            "content": {
-              "application/pdf": {
-                "schema": {
-                  "description": "Responds with an application/pdf content-type and a binary PDF",
-                  "type": "string",
-                  "$schema": "http://json-schema.org/draft-07/schema#"
-                }
-              }
-            },
-            "description": "Responds with an application/pdf content-type and a binary PDF"
-          },
-          "400": {
-            "code": 400,
-            "description": "The request contains errors or didn't properly encode content.",
-            "message": "HTTP/1.1 400 Bad Request"
-          },
-          "401": {
-            "code": 401,
-            "description": "The request is missing, or contains bad, authorization credentials.",
-            "message": "HTTP/1.1 401 Unauthorized"
-          },
-          "404": {
-            "code": 404,
-            "description": "Resource couldn't be found.",
-            "message": "HTTP/1.1 404 Not Found"
-          },
-          "408": {
-            "code": 408,
-            "description": "The request took has taken too long to process.",
-            "message": "HTTP/1.1 408 Request Timeout"
-          },
-          "429": {
-            "code": 429,
-            "description": "Too many requests are currently being processed.",
-            "message": "HTTP/1.1 429 Too Many Requests"
-          },
-          "500": {
-            "code": 500,
-            "description": "An internal error occurred when handling the request.",
-            "message": "HTTP/1.1 500 Internal Server Error"
-          }
-        },
-        "summary": "/pdf /chromium/pdf",
-        "tags": [
-          "Browser REST APIs"
-        ]
-      }
-    },
-    "/performance /chromium/performance": {
-      "post": {
-        "definitions": {},
-        "description": "Run lighthouse performance audits with a supplied \"url\" in your JSON payload.",
-        "parameters": [
-          {
-            "in": "query",
-            "name": "blockAds",
-            "schema": {
-              "description": "Whether or nor to load ad-blocking extensions for the session.\nThis currently uses uBlock-Lite and may cause certain sites\nto not load properly.",
-              "type": "boolean"
-            }
-          },
-          {
-            "in": "query",
-            "name": "launch",
-            "schema": {
-              "description": "Launch options, which can be either an object\nof puppeteer.launch options or playwright.launchServer\noptions, depending on the API. Must be either JSON\nobject, or a base64-encoded JSON object.",
-              "anyOf": [
-                {
-                  "$ref": "#/definitions/CDPLaunchOptions"
-                },
-                {
-                  "type": "string"
-                }
-              ]
-            }
-          },
-          {
-            "in": "query",
-            "name": "timeout",
-            "schema": {
-              "description": "Override the system-level timeout for this request.\nAccepts a value in milliseconds.",
-              "type": "number"
-            }
-          },
-          {
-            "in": "query",
-            "name": "token",
-            "schema": {
-              "description": "The authorization token",
-              "type": "string"
-            }
-          },
-          {
-            "in": "query",
-            "name": "trackingId",
-            "schema": {
-              "description": "Custom session identifier",
-              "type": "string"
-            }
-          }
-        ],
-        "requestBody": {
-          "content": {
-            "application/json": {
-              "schema": {
-                "properties": {
-                  "budgets": {
-                    "type": "array",
-                    "items": {
-                      "type": "object",
-                      "properties": {},
-                      "additionalProperties": true
-                    }
-                  },
-                  "config": {
-                    "type": "object",
-                    "properties": {},
-                    "additionalProperties": true
-                  },
-                  "url": {
-                    "type": "string"
-                  }
-                },
-                "type": "object"
-              }
-            }
-          }
-        },
         "responses": {
           "200": {
             "content": {
               "application/json": {
                 "schema": {
-                  "description": "The response of the lighthouse stats. Response objects are\ndetermined by the type of budgets and config in the POST\nJSON body",
-                  "type": "object",
-                  "properties": {},
-                  "additionalProperties": true,
-                  "$schema": "http://json-schema.org/draft-07/schema#"
-                }
-              }
-            },
-            "description": "The response of the lighthouse stats. Response objects are\ndetermined by the type of budgets and config in the POST\nJSON body"
-          },
-          "400": {
-            "code": 400,
-            "description": "The request contains errors or didn't properly encode content.",
-            "message": "HTTP/1.1 400 Bad Request"
-          },
-          "401": {
-            "code": 401,
-            "description": "The request is missing, or contains bad, authorization credentials.",
-            "message": "HTTP/1.1 401 Unauthorized"
-          },
-          "404": {
-            "code": 404,
-            "description": "Resource couldn't be found.",
-            "message": "HTTP/1.1 404 Not Found"
-          },
-          "408": {
-            "code": 408,
-            "description": "The request took has taken too long to process.",
-            "message": "HTTP/1.1 408 Request Timeout"
-          },
-          "429": {
-            "code": 429,
-            "description": "Too many requests are currently being processed.",
-            "message": "HTTP/1.1 429 Too Many Requests"
-          },
-          "500": {
-            "code": 500,
-            "description": "An internal error occurred when handling the request.",
-            "message": "HTTP/1.1 500 Internal Server Error"
-          }
-        },
-        "summary": "/performance /chromium/performance",
-        "tags": [
-          "Browser REST APIs"
-        ]
-      }
-    },
-    "/scrape /chromium/scrape": {
-      "post": {
-        "definitions": {},
-        "description": "A JSON-based API that returns text, html, and meta-data from a given list of selectors.\nDebugging information is available by sending in the appropriate flags in the \"debugOpts\"\nproperty. Responds with an array of JSON objects.",
-        "parameters": [
-          {
-            "in": "query",
-            "name": "blockAds",
-            "schema": {
-              "description": "Whether or nor to load ad-blocking extensions for the session.\nThis currently uses uBlock-Lite and may cause certain sites\nto not load properly.",
-              "type": "boolean"
-            }
-          },
-          {
-            "in": "query",
-            "name": "launch",
-            "schema": {
-              "anyOf": [
-                {
-                  "$ref": "#/definitions/CDPLaunchOptions"
-                },
-                {
-                  "type": "string"
-                }
-              ]
-            }
-          },
-          {
-            "in": "query",
-            "name": "timeout",
-            "schema": {
-              "description": "Override the system-level timeout for this request.\nAccepts a value in milliseconds.",
-              "type": "number"
-            }
-          },
-          {
-            "in": "query",
-            "name": "token",
-            "schema": {
-              "description": "The authorization token",
-              "type": "string"
-            }
-          },
-          {
-            "in": "query",
-            "name": "trackingId",
-            "schema": {
-              "description": "Custom session identifier",
-              "type": "string"
-            }
-          }
-        ],
-        "requestBody": {
-          "content": {
-            "application/json": {
-              "schema": {
-                "properties": {
-                  "addScriptTag": {
-                    "type": "array",
-                    "items": {
-                      "$ref": "#/definitions/FrameAddScriptTagOptions"
-                    }
-                  },
-                  "addStyleTag": {
-                    "type": "array",
-                    "items": {
-                      "$ref": "#/definitions/FrameAddStyleTagOptions"
-                    }
-                  },
-                  "authenticate": {
-                    "anyOf": [
-                      {
-                        "$ref": "#/definitions/Credentials"
-                      },
-                      {
-                        "type": "null"
-                      }
-                    ]
-                  },
-                  "bestAttempt": {
-                    "description": "When bestAttempt is set to true, browserless attempt to proceed\nwhen \"awaited\" events fail or timeout. This includes things like\ngoto, waitForSelector, and more.",
-                    "type": "boolean"
-                  },
-                  "cookies": {
-                    "type": "array",
-                    "items": {
-                      "$ref": "#/definitions/CookieParam"
-                    }
-                  },
-                  "debugOpts": {
-                    "$ref": "#/definitions/ScrapeDebugOptions"
-                  },
-                  "elements": {
-                    "type": "array",
-                    "items": {
-                      "$ref": "#/definitions/ScrapeElementSelector"
-                    }
-                  },
-                  "emulateMediaType": {
-                    "type": "string"
-                  },
-                  "gotoOptions": {
-                    "$ref": "#/definitions/GoToOptions"
-                  },
-                  "html": {
-                    "type": "string"
-                  },
-                  "rejectRequestPattern": {
-                    "type": "array",
-                    "items": {
-                      "type": "string"
-                    }
-                  },
-                  "rejectResourceTypes": {
-                    "type": "array",
-                    "items": {
-                      "enum": [
-                        "cspviolationreport",
-                        "document",
-                        "eventsource",
-                        "fetch",
-                        "font",
-                        "image",
-                        "manifest",
-                        "media",
-                        "other",
-                        "ping",
-                        "prefetch",
-                        "preflight",
-                        "script",
-                        "signedexchange",
-                        "stylesheet",
-                        "texttrack",
-                        "websocket",
-                        "xhr"
-                      ],
-                      "type": "string"
-                    }
-                  },
-                  "requestInterceptors": {
-                    "type": "array",
-                    "items": {
-                      "description": "An array of patterns (using `req.url().match(r.pattern)` to match) and their\ncorresponding responses to use in order to fulfill those requests.",
-                      "type": "object",
-                      "properties": {
-                        "pattern": {
-                          "description": "An array of patterns (using `req.url().match(r.pattern)` to match) and their\ncorresponding responses to use in order to fulfill those requests.",
-                          "type": "string"
-                        },
-                        "response": {
-                          "$ref": "#/definitions/Partial<ResponseForRequest>"
-                        }
-                      },
-                      "additionalProperties": false,
-                      "required": [
-                        "pattern",
-                        "response"
-                      ]
-                    }
-                  },
-                  "setExtraHTTPHeaders": {
-                    "$ref": "#/definitions/Record<string,string>"
-                  },
-                  "setJavaScriptEnabled": {
-                    "type": "boolean"
-                  },
-                  "url": {
-                    "type": "string"
-                  },
-                  "userAgent": {
-                    "type": "string"
-                  },
-                  "viewport": {
-                    "anyOf": [
-                      {
-                        "$ref": "#/definitions/Viewport"
-                      },
-                      {
-                        "type": "null"
-                      }
-                    ]
-                  },
-                  "waitForEvent": {
-                    "type": "object",
-                    "properties": {
-                      "event": {
-                        "type": "string"
-                      },
-                      "timeout": {
-                        "type": "number"
-                      }
-                    },
-                    "additionalProperties": false,
-                    "required": [
-                      "event"
-                    ]
-                  },
-                  "waitForFunction": {
-                    "type": "object",
-                    "properties": {
-                      "fn": {
-                        "description": "The function, or statement, to be evaluated in browser context",
-                        "type": "string"
-                      },
-                      "polling": {
-                        "description": "An interval at which the pageFunction is executed, defaults to raf.\nIf polling is a number, then it is treated as an interval in milliseconds\nat which the function would be executed. If polling is a string,\nthen it can be one of the following values: \"raf\" or \"mutation\"",
-                        "type": [
-                          "string",
-                          "number"
-                        ]
-                      },
-                      "timeout": {
-                        "description": "Maximum time to wait for in milliseconds. Defaults to 30000 (30 seconds).\nPass 0 to disable timeout.",
-                        "type": "number"
-                      }
-                    },
-                    "additionalProperties": false,
-                    "required": [
-                      "fn"
-                    ]
-                  },
-                  "waitForSelector": {
-                    "type": "object",
-                    "properties": {
-                      "hidden": {
-                        "type": "boolean"
-                      },
-                      "selector": {
-                        "type": "string"
-                      },
-                      "timeout": {
-                        "type": "number"
-                      },
-                      "visible": {
-                        "type": "boolean"
-                      }
-                    },
-                    "additionalProperties": false,
-                    "required": [
-                      "selector"
-                    ]
-                  },
-                  "waitForTimeout": {
-                    "type": "number"
-                  }
-                },
-                "type": "object"
-              }
-            }
-          }
-        },
-        "responses": {
-          "200": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "description": "The JSON response body",
+                  "description": "The JSON response body",
                   "type": "object",
                   "properties": {
                     "data": {
@@ -5537,204 +5149,10 @@
         ]
       }
     },
-    " /chromium": {
-      "get": {
+    "/edge/content": {
+      "post": {
         "definitions": {},
-        "description": "Launch and connect to Chromium with a library like puppeteer or others that work over chrome-devtools-protocol.",
-        "parameters": [
-          {
-            "in": "query",
-            "name": "blockAds",
-            "schema": {
-              "description": "Whether or nor to load ad-blocking extensions for the session.\nThis currently uses uBlock-Lite and may cause certain sites\nto not load properly.",
-              "type": "boolean"
-            }
-          },
-          {
-            "in": "query",
-            "name": "launch",
-            "schema": {
-              "description": "Launch options, which can be either an object\nof puppeteer.launch options or playwright.launchServer\noptions, depending on the API. Must be either JSON\nobject, or a base64-encoded JSON object.",
-              "anyOf": [
-                {
-                  "$ref": "#/definitions/CDPLaunchOptions"
-                },
-                {
-                  "type": "string"
-                }
-              ]
-            }
-          },
-          {
-            "in": "query",
-            "name": "timeout",
-            "schema": {
-              "description": "Override the system-level timeout for this request.\nAccepts a value in milliseconds.",
-              "type": "number"
-            }
-          },
-          {
-            "in": "query",
-            "name": "token",
-            "schema": {
-              "description": "The authorization token",
-              "type": "string"
-            }
-          },
-          {
-            "in": "query",
-            "name": "trackingId",
-            "schema": {
-              "description": "Custom session identifier",
-              "type": "string"
-            }
-          }
-        ],
-        "requestBody": {
-          "content": {}
-        },
-        "responses": {
-          "101": {
-            "description": "Indicates successful WebSocket upgrade."
-          },
-          "400": {
-            "code": 400,
-            "description": "The request contains errors or didn't properly encode content.",
-            "message": "HTTP/1.1 400 Bad Request"
-          },
-          "401": {
-            "code": 401,
-            "description": "The request is missing, or contains bad, authorization credentials.",
-            "message": "HTTP/1.1 401 Unauthorized"
-          },
-          "404": {
-            "code": 404,
-            "description": "Resource couldn't be found.",
-            "message": "HTTP/1.1 404 Not Found"
-          },
-          "408": {
-            "code": 408,
-            "description": "The request took has taken too long to process.",
-            "message": "HTTP/1.1 408 Request Timeout"
-          },
-          "429": {
-            "code": 429,
-            "description": "Too many requests are currently being processed.",
-            "message": "HTTP/1.1 429 Too Many Requests"
-          },
-          "500": {
-            "code": 500,
-            "description": "An internal error occurred when handling the request.",
-            "message": "HTTP/1.1 500 Internal Server Error"
-          }
-        },
-        "summary": " /chromium",
-        "tags": [
-          "Browser WebSocket APIs"
-        ]
-      }
-    },
-    "/playwright/chromium /chromium/playwright": {
-      "get": {
-        "definitions": {},
-        "description": "Connect to Chromium with any playwright style library.",
-        "parameters": [
-          {
-            "in": "query",
-            "name": "blockAds",
-            "schema": {
-              "description": "Whether or nor to load ad-blocking extensions for the session.\nThis currently uses uBlock-Lite and may cause certain sites\nto not load properly.",
-              "type": "boolean"
-            }
-          },
-          {
-            "in": "query",
-            "name": "launch",
-            "schema": {
-              "description": "Launch options, which can be either an object\nof puppeteer.launch options or playwright.launchServer\noptions, depending on the API. Must be either JSON\nobject, or a base64-encoded JSON object.",
-              "anyOf": [
-                {
-                  "$ref": "#/definitions/BrowserServerOptions"
-                },
-                {
-                  "type": "string"
-                }
-              ]
-            }
-          },
-          {
-            "in": "query",
-            "name": "timeout",
-            "schema": {
-              "description": "Override the system-level timeout for this request.\nAccepts a value in milliseconds.",
-              "type": "number"
-            }
-          },
-          {
-            "in": "query",
-            "name": "token",
-            "schema": {
-              "description": "The authorization token",
-              "type": "string"
-            }
-          },
-          {
-            "in": "query",
-            "name": "trackingId",
-            "schema": {
-              "description": "Custom session identifier",
-              "type": "string"
-            }
-          }
-        ],
-        "requestBody": {
-          "content": {}
-        },
-        "responses": {
-          "101": {
-            "description": "Indicates successful WebSocket upgrade."
-          },
-          "400": {
-            "code": 400,
-            "description": "The request contains errors or didn't properly encode content.",
-            "message": "HTTP/1.1 400 Bad Request"
-          },
-          "401": {
-            "code": 401,
-            "description": "The request is missing, or contains bad, authorization credentials.",
-            "message": "HTTP/1.1 401 Unauthorized"
-          },
-          "404": {
-            "code": 404,
-            "description": "Resource couldn't be found.",
-            "message": "HTTP/1.1 404 Not Found"
-          },
-          "408": {
-            "code": 408,
-            "description": "The request took has taken too long to process.",
-            "message": "HTTP/1.1 408 Request Timeout"
-          },
-          "429": {
-            "code": 429,
-            "description": "Too many requests are currently being processed.",
-            "message": "HTTP/1.1 429 Too Many Requests"
-          },
-          "500": {
-            "code": 500,
-            "description": "An internal error occurred when handling the request.",
-            "message": "HTTP/1.1 500 Internal Server Error"
-          }
-        },
-        "summary": "/playwright/chromium /chromium/playwright",
-        "tags": [
-          "Browser WebSocket APIs"
-        ]
-      }
-    },
-    "/edge/content": {
-      "post": {
-        "definitions": {},
-        "description": "A JSON-based API. Given a \"url\" or \"html\" field, runs and returns HTML content after the page has loaded and JavaScript has parsed.",
+        "description": "A JSON-based API. Given a \"url\" or \"html\" field, runs and returns HTML content after the page has loaded and JavaScript has parsed.",
         "parameters": [
           {
             "in": "query",
@@ -7624,66 +7042,15 @@
         ]
       }
     },
-    "/edge": {
+    "/active": {
       "get": {
         "definitions": {},
-        "description": "Launch and connect to Chromium with a library like puppeteer or others that work over chrome-devtools-protocol.",
-        "parameters": [
-          {
-            "in": "query",
-            "name": "blockAds",
-            "schema": {
-              "description": "Whether or nor to load ad-blocking extensions for the session.\nThis currently uses uBlock-Lite and may cause certain sites\nto not load properly.",
-              "type": "boolean"
-            }
-          },
-          {
-            "in": "query",
-            "name": "launch",
-            "schema": {
-              "description": "Launch options, which can be either an object\nof puppeteer.launch options or playwright.launchServer\noptions, depending on the API. Must be either JSON\nobject, or a base64-encoded JSON object.",
-              "anyOf": [
-                {
-                  "$ref": "#/definitions/CDPLaunchOptions"
-                },
-                {
-                  "type": "string"
-                }
-              ]
-            }
-          },
-          {
-            "in": "query",
-            "name": "timeout",
-            "schema": {
-              "description": "Override the system-level timeout for this request.\nAccepts a value in milliseconds.",
-              "type": "number"
-            }
-          },
-          {
-            "in": "query",
-            "name": "token",
-            "schema": {
-              "description": "The authorization token",
-              "type": "string"
-            }
-          },
-          {
-            "in": "query",
-            "name": "trackingId",
-            "schema": {
-              "description": "Custom session identifier",
-              "type": "string"
-            }
-          }
-        ],
+        "description": "Returns a simple \"204\" HTTP code, with no response, indicating that the service itself is up and running.\nUseful for liveliness probes or other external checks.",
+        "parameters": [],
         "requestBody": {
           "content": {}
         },
         "responses": {
-          "101": {
-            "description": "Indicates successful WebSocket upgrade."
-          },
           "400": {
             "code": 400,
             "description": "The request contains errors or didn't properly encode content.",
@@ -7715,31 +7082,558 @@
             "message": "HTTP/1.1 500 Internal Server Error"
           }
         },
-        "summary": "/edge",
+        "summary": "/active",
         "tags": [
-          "Browser WebSocket APIs"
+          "Management REST APIs"
         ]
       }
     },
-    "/edge/playwright": {
+    "/config": {
       "get": {
         "definitions": {},
-        "description": "Connect to Chromium with any playwright style library.",
-        "parameters": [
-          {
-            "in": "query",
-            "name": "blockAds",
-            "schema": {
-              "description": "Whether or nor to load ad-blocking extensions for the session.\nThis currently uses uBlock-Lite and may cause certain sites\nto not load properly.",
-              "type": "boolean"
-            }
-          },
-          {
-            "in": "query",
-            "name": "launch",
-            "schema": {
-              "description": "Launch options, which can be either an object\nof puppeteer.launch options or playwright.launchServer\noptions, depending on the API. Must be either JSON\nobject, or a base64-encoded JSON object.",
+        "description": "Returns a JSON payload of the current system configuration.",
+        "parameters": [],
+        "requestBody": {
+          "content": {}
+        },
+        "responses": {
+          "200": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "allowCORS": {
+                      "type": "boolean"
+                    },
+                    "allowFileProtocol": {
+                      "type": "boolean"
+                    },
+                    "allowGetCalls": {
+                      "type": "boolean"
+                    },
+                    "concurrent": {
+                      "type": "number"
+                    },
+                    "data": {
+                      "type": "string"
+                    },
+                    "debug": {
+                      "type": "string"
+                    },
+                    "errorAlertURL": {
+                      "type": [
+                        "null",
+                        "string"
+                      ]
+                    },
+                    "healthFailureURL": {
+                      "type": [
+                        "null",
+                        "string"
+                      ]
+                    },
+                    "host": {
+                      "type": "string"
+                    },
+                    "maxCPU": {
+                      "type": "number"
+                    },
+                    "maxMemory": {
+                      "type": "number"
+                    },
+                    "metricsJSONPath": {
+                      "type": "string"
+                    },
+                    "port": {
+                      "type": "number"
+                    },
+                    "queued": {
+                      "type": "number"
+                    },
+                    "queuedAlertURL": {
+                      "type": [
+                        "null",
+                        "string"
+                      ]
+                    },
+                    "rejectAlertURL": {
+                      "type": [
+                        "null",
+                        "string"
+                      ]
+                    },
+                    "retries": {
+                      "type": "number"
+                    },
+                    "timeout": {
+                      "type": "number"
+                    },
+                    "timeoutAlertURL": {
+                      "type": [
+                        "null",
+                        "string"
+                      ]
+                    },
+                    "token": {
+                      "type": [
+                        "null",
+                        "string"
+                      ]
+                    }
+                  },
+                  "additionalProperties": false,
+                  "required": [
+                    "allowCORS",
+                    "allowFileProtocol",
+                    "allowGetCalls",
+                    "concurrent",
+                    "data",
+                    "debug",
+                    "errorAlertURL",
+                    "healthFailureURL",
+                    "host",
+                    "maxCPU",
+                    "maxMemory",
+                    "metricsJSONPath",
+                    "port",
+                    "queued",
+                    "queuedAlertURL",
+                    "rejectAlertURL",
+                    "retries",
+                    "timeout",
+                    "timeoutAlertURL",
+                    "token"
+                  ],
+                  "$schema": "http://json-schema.org/draft-07/schema#"
+                }
+              }
+            }
+          },
+          "400": {
+            "code": 400,
+            "description": "The request contains errors or didn't properly encode content.",
+            "message": "HTTP/1.1 400 Bad Request"
+          },
+          "401": {
+            "code": 401,
+            "description": "The request is missing, or contains bad, authorization credentials.",
+            "message": "HTTP/1.1 401 Unauthorized"
+          },
+          "404": {
+            "code": 404,
+            "description": "Resource couldn't be found.",
+            "message": "HTTP/1.1 404 Not Found"
+          },
+          "408": {
+            "code": 408,
+            "description": "The request took has taken too long to process.",
+            "message": "HTTP/1.1 408 Request Timeout"
+          },
+          "429": {
+            "code": 429,
+            "description": "Too many requests are currently being processed.",
+            "message": "HTTP/1.1 429 Too Many Requests"
+          },
+          "500": {
+            "code": 500,
+            "description": "An internal error occurred when handling the request.",
+            "message": "HTTP/1.1 500 Internal Server Error"
+          }
+        },
+        "summary": "/config",
+        "tags": [
+          "Management REST APIs"
+        ]
+      }
+    },
+    "/kill/+([0-9a-zA-Z-_])": {
+      "get": {
+        "definitions": {},
+        "description": "Kill running sessions based on BrowserId or TrackingId.",
+        "parameters": [
+          {
+            "in": "query",
+            "name": "token",
+            "required": true,
+            "schema": {
+              "description": "The authorization token",
+              "type": "string"
+            }
+          },
+          {
+            "in": "query",
+            "name": "blockAds",
+            "required": false,
+            "schema": {
+              "description": "Whether or nor to load ad-blocking extensions for the session.\nThis currently uses uBlock-Lite and may cause certain sites\nto not load properly.",
+              "type": "boolean"
+            }
+          },
+          {
+            "in": "query",
+            "name": "browserId",
+            "required": false,
+            "schema": {
+              "type": "string"
+            }
+          },
+          {
+            "in": "query",
+            "name": "launch",
+            "required": false,
+            "schema": {
+              "description": "Launch options, which can be either an object\nof puppeteer.launch options or playwright.launchServer\noptions, depending on the API. Must be either JSON\nobject, or a base64-encoded JSON object.",
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/CDPLaunchOptions"
+                },
+                {
+                  "$ref": "#/definitions/BrowserServerOptions"
+                },
+                {
+                  "type": "string"
+                }
+              ]
+            }
+          },
+          {
+            "in": "query",
+            "name": "timeout",
+            "required": false,
+            "schema": {
+              "description": "Override the system-level timeout for this request.\nAccepts a value in milliseconds.",
+              "type": "number"
+            }
+          },
+          {
+            "in": "query",
+            "name": "trackingId",
+            "required": false,
+            "schema": {
+              "description": "Custom session identifier",
+              "type": "string"
+            }
+          }
+        ],
+        "requestBody": {
+          "content": {}
+        },
+        "responses": {
+          "400": {
+            "code": 400,
+            "description": "The request contains errors or didn't properly encode content.",
+            "message": "HTTP/1.1 400 Bad Request"
+          },
+          "401": {
+            "code": 401,
+            "description": "The request is missing, or contains bad, authorization credentials.",
+            "message": "HTTP/1.1 401 Unauthorized"
+          },
+          "404": {
+            "code": 404,
+            "description": "Resource couldn't be found.",
+            "message": "HTTP/1.1 404 Not Found"
+          },
+          "408": {
+            "code": 408,
+            "description": "The request took has taken too long to process.",
+            "message": "HTTP/1.1 408 Request Timeout"
+          },
+          "429": {
+            "code": 429,
+            "description": "Too many requests are currently being processed.",
+            "message": "HTTP/1.1 429 Too Many Requests"
+          },
+          "500": {
+            "code": 500,
+            "description": "An internal error occurred when handling the request.",
+            "message": "HTTP/1.1 500 Internal Server Error"
+          }
+        },
+        "summary": "/kill/+([0-9a-zA-Z-_])",
+        "tags": [
+          "Management REST APIs"
+        ]
+      }
+    },
+    "/meta": {
+      "get": {
+        "definitions": {},
+        "description": "Returns a JSON payload of the current system versions, including the core API version.",
+        "parameters": [],
+        "requestBody": {
+          "content": {}
+        },
+        "responses": {
+          "200": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "version": {
+                      "description": "The semantic version of the Browserless API",
+                      "type": "string"
+                    },
+                    "chromium": {
+                      "description": "The version of Chromium installed, or null if not installed",
+                      "type": [
+                        "null",
+                        "string"
+                      ]
+                    },
+                    "webkit": {
+                      "description": "The version of Webkit installed, or null if not installed",
+                      "type": [
+                        "null",
+                        "string"
+                      ]
+                    },
+                    "firefox": {
+                      "description": "The version of Firefox installed, or null if not installed",
+                      "type": [
+                        "null",
+                        "string"
+                      ]
+                    },
+                    "playwright": {
+                      "description": "The supported version(s) of puppeteer",
+                      "type": "array",
+                      "items": {
+                        "type": "string"
+                      }
+                    },
+                    "puppeteer": {
+                      "description": "The supported version(s) of playwright",
+                      "type": "array",
+                      "items": {
+                        "type": "string"
+                      }
+                    }
+                  },
+                  "additionalProperties": false,
+                  "required": [
+                    "chromium",
+                    "firefox",
+                    "playwright",
+                    "puppeteer",
+                    "version",
+                    "webkit"
+                  ],
+                  "$schema": "http://json-schema.org/draft-07/schema#"
+                }
+              }
+            }
+          },
+          "400": {
+            "code": 400,
+            "description": "The request contains errors or didn't properly encode content.",
+            "message": "HTTP/1.1 400 Bad Request"
+          },
+          "401": {
+            "code": 401,
+            "description": "The request is missing, or contains bad, authorization credentials.",
+            "message": "HTTP/1.1 401 Unauthorized"
+          },
+          "404": {
+            "code": 404,
+            "description": "Resource couldn't be found.",
+            "message": "HTTP/1.1 404 Not Found"
+          },
+          "408": {
+            "code": 408,
+            "description": "The request took has taken too long to process.",
+            "message": "HTTP/1.1 408 Request Timeout"
+          },
+          "429": {
+            "code": 429,
+            "description": "Too many requests are currently being processed.",
+            "message": "HTTP/1.1 429 Too Many Requests"
+          },
+          "500": {
+            "code": 500,
+            "description": "An internal error occurred when handling the request.",
+            "message": "HTTP/1.1 500 Internal Server Error"
+          }
+        },
+        "summary": "/meta",
+        "tags": [
+          "Management REST APIs"
+        ]
+      }
+    },
+    "/metrics/total": {
+      "get": {
+        "definitions": {},
+        "description": "Gets total metric details summed from the time the server started.",
+        "parameters": [],
+        "requestBody": {
+          "content": {}
+        },
+        "responses": {
+          "400": {
+            "code": 400,
+            "description": "The request contains errors or didn't properly encode content.",
+            "message": "HTTP/1.1 400 Bad Request"
+          },
+          "401": {
+            "code": 401,
+            "description": "The request is missing, or contains bad, authorization credentials.",
+            "message": "HTTP/1.1 401 Unauthorized"
+          },
+          "404": {
+            "code": 404,
+            "description": "Resource couldn't be found.",
+            "message": "HTTP/1.1 404 Not Found"
+          },
+          "408": {
+            "code": 408,
+            "description": "The request took has taken too long to process.",
+            "message": "HTTP/1.1 408 Request Timeout"
+          },
+          "429": {
+            "code": 429,
+            "description": "Too many requests are currently being processed.",
+            "message": "HTTP/1.1 429 Too Many Requests"
+          },
+          "500": {
+            "code": 500,
+            "description": "An internal error occurred when handling the request.",
+            "message": "HTTP/1.1 500 Internal Server Error"
+          }
+        },
+        "summary": "/metrics/total",
+        "tags": [
+          "Management REST APIs"
+        ]
+      }
+    },
+    "/metrics": {
+      "get": {
+        "definitions": {},
+        "description": "Returns a list of metric details as far back as possible.",
+        "parameters": [],
+        "requestBody": {
+          "content": {}
+        },
+        "responses": {
+          "400": {
+            "code": 400,
+            "description": "The request contains errors or didn't properly encode content.",
+            "message": "HTTP/1.1 400 Bad Request"
+          },
+          "401": {
+            "code": 401,
+            "description": "The request is missing, or contains bad, authorization credentials.",
+            "message": "HTTP/1.1 401 Unauthorized"
+          },
+          "404": {
+            "code": 404,
+            "description": "Resource couldn't be found.",
+            "message": "HTTP/1.1 404 Not Found"
+          },
+          "408": {
+            "code": 408,
+            "description": "The request took has taken too long to process.",
+            "message": "HTTP/1.1 408 Request Timeout"
+          },
+          "429": {
+            "code": 429,
+            "description": "Too many requests are currently being processed.",
+            "message": "HTTP/1.1 429 Too Many Requests"
+          },
+          "500": {
+            "code": 500,
+            "description": "An internal error occurred when handling the request.",
+            "message": "HTTP/1.1 500 Internal Server Error"
+          }
+        },
+        "summary": "/metrics",
+        "tags": [
+          "Management REST APIs"
+        ]
+      }
+    },
+    "/pressure": {
+      "get": {
+        "definitions": {},
+        "description": "Returns a JSON body of stats related to the pressure being created on the instance.",
+        "parameters": [],
+        "requestBody": {
+          "content": {}
+        },
+        "responses": {
+          "400": {
+            "code": 400,
+            "description": "The request contains errors or didn't properly encode content.",
+            "message": "HTTP/1.1 400 Bad Request"
+          },
+          "401": {
+            "code": 401,
+            "description": "The request is missing, or contains bad, authorization credentials.",
+            "message": "HTTP/1.1 401 Unauthorized"
+          },
+          "404": {
+            "code": 404,
+            "description": "Resource couldn't be found.",
+            "message": "HTTP/1.1 404 Not Found"
+          },
+          "408": {
+            "code": 408,
+            "description": "The request took has taken too long to process.",
+            "message": "HTTP/1.1 408 Request Timeout"
+          },
+          "429": {
+            "code": 429,
+            "description": "Too many requests are currently being processed.",
+            "message": "HTTP/1.1 429 Too Many Requests"
+          },
+          "500": {
+            "code": 500,
+            "description": "An internal error occurred when handling the request.",
+            "message": "HTTP/1.1 500 Internal Server Error"
+          }
+        },
+        "summary": "/pressure",
+        "tags": [
+          "Management REST APIs"
+        ]
+      }
+    },
+    "/sessions": {
+      "get": {
+        "definitions": {},
+        "description": "Lists all currently running sessions and relevant meta-data excluding potentially open pages.",
+        "parameters": [
+          {
+            "in": "query",
+            "name": "token",
+            "required": true,
+            "schema": {
+              "description": "The authorization token",
+              "type": "string"
+            }
+          },
+          {
+            "in": "query",
+            "name": "blockAds",
+            "required": false,
+            "schema": {
+              "description": "Whether or nor to load ad-blocking extensions for the session.\nThis currently uses uBlock-Lite and may cause certain sites\nto not load properly.",
+              "type": "boolean"
+            }
+          },
+          {
+            "in": "query",
+            "name": "launch",
+            "required": false,
+            "schema": {
+              "description": "Launch options, which can be either an object\nof puppeteer.launch options or playwright.launchServer\noptions, depending on the API. Must be either JSON\nobject, or a base64-encoded JSON object.",
               "anyOf": [
+                {
+                  "$ref": "#/definitions/CDPLaunchOptions"
+                },
                 {
                   "$ref": "#/definitions/BrowserServerOptions"
                 },
@@ -7752,22 +7646,16 @@
           {
             "in": "query",
             "name": "timeout",
+            "required": false,
             "schema": {
               "description": "Override the system-level timeout for this request.\nAccepts a value in milliseconds.",
               "type": "number"
             }
           },
-          {
-            "in": "query",
-            "name": "token",
-            "schema": {
-              "description": "The authorization token",
-              "type": "string"
-            }
-          },
           {
             "in": "query",
             "name": "trackingId",
+            "required": false,
             "schema": {
               "description": "Custom session identifier",
               "type": "string"
@@ -7778,9 +7666,6 @@
           "content": {}
         },
         "responses": {
-          "101": {
-            "description": "Indicates successful WebSocket upgrade."
-          },
           "400": {
             "code": 400,
             "description": "The request contains errors or didn't properly encode content.",
@@ -7812,102 +7697,84 @@
             "message": "HTTP/1.1 500 Internal Server Error"
           }
         },
-        "summary": "/edge/playwright",
+        "summary": "/sessions",
         "tags": [
-          "Browser WebSocket APIs"
+          "Management REST APIs"
         ]
       }
     },
-    "/playwright/firefox /firefox/playwright": {
+    "/": {
       "get": {
         "definitions": {},
-        "description": "Connect to Firefox with any playwright-compliant library.",
-        "parameters": [
-          {
-            "in": "query",
-            "name": "blockAds",
-            "schema": {
-              "description": "Whether or nor to load ad-blocking extensions for the session.\nThis currently uses uBlock-Lite and may cause certain sites\nto not load properly.",
-              "type": "boolean"
-            }
+        "description": "Serves static files inside of this \"static\" directory. Content-types will vary depending on the type =of file being returned.",
+        "parameters": [],
+        "requestBody": {
+          "content": {}
+        },
+        "responses": {
+          "400": {
+            "code": 400,
+            "description": "The request contains errors or didn't properly encode content.",
+            "message": "HTTP/1.1 400 Bad Request"
           },
-          {
-            "in": "query",
-            "name": "launch",
-            "schema": {
-              "description": "Launch options, which can be either an object\nof puppeteer.launch options or playwright.launchServer\noptions, depending on the API. Must be either JSON\nobject, or a base64-encoded JSON object.",
-              "additionalProperties": false,
-              "type": "object",
-              "properties": {
-                "args": {
-                  "type": "array",
-                  "items": {
-                    "type": "string"
-                  }
-                },
-                "chromiumSandbox": {
-                  "type": "boolean"
-                },
-                "devtools": {
-                  "type": "boolean"
-                },
-                "downloadsPath": {
-                  "type": "string"
-                },
-                "headless": {
-                  "type": "boolean"
-                },
-                "ignoreDefaultArgs": {
-                  "anyOf": [
-                    {
-                      "type": "array",
-                      "items": {
-                        "type": "string"
-                      }
-                    },
-                    {
-                      "type": "boolean"
-                    }
-                  ]
-                },
-                "proxy": {
-                  "type": "object",
-                  "properties": {
-                    "bypass": {
-                      "type": "string"
-                    },
-                    "password": {
-                      "type": "string"
-                    },
-                    "server": {
-                      "type": "string"
-                    },
-                    "username": {
-                      "type": "string"
-                    }
-                  },
-                  "additionalProperties": false,
-                  "required": [
-                    "server"
-                  ]
-                },
-                "timeout": {
-                  "type": "number"
+          "401": {
+            "code": 401,
+            "description": "The request is missing, or contains bad, authorization credentials.",
+            "message": "HTTP/1.1 401 Unauthorized"
+          },
+          "404": {
+            "code": 404,
+            "description": "Resource couldn't be found.",
+            "message": "HTTP/1.1 404 Not Found"
+          },
+          "408": {
+            "code": 408,
+            "description": "The request took has taken too long to process.",
+            "message": "HTTP/1.1 408 Request Timeout"
+          },
+          "429": {
+            "code": 429,
+            "description": "Too many requests are currently being processed.",
+            "message": "HTTP/1.1 429 Too Many Requests"
+          },
+          "500": {
+            "code": 500,
+            "description": "An internal error occurred when handling the request.",
+            "message": "HTTP/1.1 500 Internal Server Error"
+          }
+        },
+        "summary": "/",
+        "tags": [
+          "Management REST APIs"
+        ]
+      }
+    },
+    "/devtools/browser/*": {
+      "get": {
+        "definitions": {},
+        "description": "Connect to an already-running Chromium process with a library like\npuppeteer, or others, that work over chrome-devtools-protocol. Chromium\nmust already be launched in order to not return a 404.",
+        "parameters": [
+          {
+            "in": "query",
+            "name": "blockAds",
+            "schema": {
+              "description": "Whether or nor to load ad-blocking extensions for the session.\nThis currently uses uBlock-Lite and may cause certain sites\nto not load properly.",
+              "type": "boolean"
+            }
+          },
+          {
+            "in": "query",
+            "name": "launch",
+            "schema": {
+              "description": "Launch options, which can be either an object\nof puppeteer.launch options or playwright.launchServer\noptions, depending on the API. Must be either JSON\nobject, or a base64-encoded JSON object.",
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/CDPLaunchOptions"
                 },
-                "tracesDir": {
+                {
                   "type": "string"
-                },
-                "firefoxUserPrefs": {
-                  "type": "object",
-                  "additionalProperties": {
-                    "type": [
-                      "string",
-                      "number",
-                      "boolean"
-                    ]
-                  }
                 }
-              }
+              ]
             }
           },
           {
@@ -7973,21 +7840,72 @@
             "message": "HTTP/1.1 500 Internal Server Error"
           }
         },
-        "summary": "/playwright/firefox /firefox/playwright",
+        "summary": "/devtools/browser/*",
         "tags": [
           "Browser WebSocket APIs"
         ]
       }
     },
-    "/active": {
+    "/chrome": {
       "get": {
         "definitions": {},
-        "description": "Returns a simple \"204\" HTTP code, with no response, indicating that the service itself is up and running.\nUseful for liveliness probes or other external checks.",
-        "parameters": [],
+        "description": "Launch and connect to Chromium with a library like puppeteer or others that work over chrome-devtools-protocol.",
+        "parameters": [
+          {
+            "in": "query",
+            "name": "blockAds",
+            "schema": {
+              "description": "Whether or nor to load ad-blocking extensions for the session.\nThis currently uses uBlock-Lite and may cause certain sites\nto not load properly.",
+              "type": "boolean"
+            }
+          },
+          {
+            "in": "query",
+            "name": "launch",
+            "schema": {
+              "description": "Launch options, which can be either an object\nof puppeteer.launch options or playwright.launchServer\noptions, depending on the API. Must be either JSON\nobject, or a base64-encoded JSON object.",
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/CDPLaunchOptions"
+                },
+                {
+                  "type": "string"
+                }
+              ]
+            }
+          },
+          {
+            "in": "query",
+            "name": "timeout",
+            "schema": {
+              "description": "Override the system-level timeout for this request.\nAccepts a value in milliseconds.",
+              "type": "number"
+            }
+          },
+          {
+            "in": "query",
+            "name": "token",
+            "schema": {
+              "description": "The authorization token",
+              "type": "string"
+            }
+          },
+          {
+            "in": "query",
+            "name": "trackingId",
+            "schema": {
+              "description": "Custom session identifier",
+              "type": "string"
+            }
+          }
+        ],
         "requestBody": {
           "content": {}
         },
         "responses": {
+          "101": {
+            "description": "Indicates successful WebSocket upgrade."
+          },
           "400": {
             "code": 400,
             "description": "The request contains errors or didn't properly encode content.",
@@ -8019,133 +7937,71 @@
             "message": "HTTP/1.1 500 Internal Server Error"
           }
         },
-        "summary": "/active",
+        "summary": "/chrome",
         "tags": [
-          "Management REST APIs"
+          "Browser WebSocket APIs"
         ]
       }
     },
-    "/config": {
+    "/devtools/page/*": {
       "get": {
         "definitions": {},
-        "description": "Returns a JSON payload of the current system configuration.",
-        "parameters": [],
-        "requestBody": {
-          "content": {}
-        },
-        "responses": {
-          "200": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "type": "object",
-                  "properties": {
-                    "allowCORS": {
-                      "type": "boolean"
-                    },
-                    "allowFileProtocol": {
-                      "type": "boolean"
-                    },
-                    "allowGetCalls": {
-                      "type": "boolean"
-                    },
-                    "concurrent": {
-                      "type": "number"
-                    },
-                    "data": {
-                      "type": "string"
-                    },
-                    "debug": {
-                      "type": "string"
-                    },
-                    "errorAlertURL": {
-                      "type": [
-                        "null",
-                        "string"
-                      ]
-                    },
-                    "healthFailureURL": {
-                      "type": [
-                        "null",
-                        "string"
-                      ]
-                    },
-                    "host": {
-                      "type": "string"
-                    },
-                    "maxCPU": {
-                      "type": "number"
-                    },
-                    "maxMemory": {
-                      "type": "number"
-                    },
-                    "metricsJSONPath": {
-                      "type": "string"
-                    },
-                    "port": {
-                      "type": "number"
-                    },
-                    "queued": {
-                      "type": "number"
-                    },
-                    "queuedAlertURL": {
-                      "type": [
-                        "null",
-                        "string"
-                      ]
-                    },
-                    "rejectAlertURL": {
-                      "type": [
-                        "null",
-                        "string"
-                      ]
-                    },
-                    "retries": {
-                      "type": "number"
-                    },
-                    "timeout": {
-                      "type": "number"
-                    },
-                    "timeoutAlertURL": {
-                      "type": [
-                        "null",
-                        "string"
-                      ]
-                    },
-                    "token": {
-                      "type": [
-                        "null",
-                        "string"
-                      ]
-                    }
-                  },
-                  "additionalProperties": false,
-                  "required": [
-                    "allowCORS",
-                    "allowFileProtocol",
-                    "allowGetCalls",
-                    "concurrent",
-                    "data",
-                    "debug",
-                    "errorAlertURL",
-                    "healthFailureURL",
-                    "host",
-                    "maxCPU",
-                    "maxMemory",
-                    "metricsJSONPath",
-                    "port",
-                    "queued",
-                    "queuedAlertURL",
-                    "rejectAlertURL",
-                    "retries",
-                    "timeout",
-                    "timeoutAlertURL",
-                    "token"
-                  ],
-                  "$schema": "http://json-schema.org/draft-07/schema#"
+        "description": "Connect to an existing page in Chromium with a library like\nchrome-remote-interface or others that work the page websocketDebugger\nURL. You can get this unique URL by calling the /json/list API\nor by finding the page's unique ID from your library of choice.",
+        "parameters": [
+          {
+            "in": "query",
+            "name": "blockAds",
+            "schema": {
+              "description": "Whether or nor to load ad-blocking extensions for the session.\nThis currently uses uBlock-Lite and may cause certain sites\nto not load properly.",
+              "type": "boolean"
+            }
+          },
+          {
+            "in": "query",
+            "name": "launch",
+            "schema": {
+              "description": "Launch options, which can be either an object\nof puppeteer.launch options or playwright.launchServer\noptions, depending on the API. Must be either JSON\nobject, or a base64-encoded JSON object.",
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/CDPLaunchOptions"
+                },
+                {
+                  "type": "string"
                 }
-              }
+              ]
+            }
+          },
+          {
+            "in": "query",
+            "name": "timeout",
+            "schema": {
+              "description": "Override the system-level timeout for this request.\nAccepts a value in milliseconds.",
+              "type": "number"
+            }
+          },
+          {
+            "in": "query",
+            "name": "token",
+            "schema": {
+              "description": "The authorization token",
+              "type": "string"
+            }
+          },
+          {
+            "in": "query",
+            "name": "trackingId",
+            "schema": {
+              "description": "Custom session identifier",
+              "type": "string"
             }
+          }
+        ],
+        "requestBody": {
+          "content": {}
+        },
+        "responses": {
+          "101": {
+            "description": "Indicates successful WebSocket upgrade."
           },
           "400": {
             "code": 400,
@@ -8178,53 +8034,31 @@
             "message": "HTTP/1.1 500 Internal Server Error"
           }
         },
-        "summary": "/config",
+        "summary": "/devtools/page/*",
         "tags": [
-          "Management REST APIs"
+          "Browser WebSocket APIs"
         ]
       }
     },
-    "/kill/+([0-9a-zA-Z-_])": {
+    "/chrome/playwright": {
       "get": {
         "definitions": {},
-        "description": "Kill running sessions based on BrowserId or TrackingId.",
+        "description": "Connect to Chromium with any playwright style library.",
         "parameters": [
-          {
-            "in": "query",
-            "name": "token",
-            "required": true,
-            "schema": {
-              "description": "The authorization token",
-              "type": "string"
-            }
-          },
           {
             "in": "query",
             "name": "blockAds",
-            "required": false,
             "schema": {
               "description": "Whether or nor to load ad-blocking extensions for the session.\nThis currently uses uBlock-Lite and may cause certain sites\nto not load properly.",
               "type": "boolean"
             }
           },
-          {
-            "in": "query",
-            "name": "browserId",
-            "required": false,
-            "schema": {
-              "type": "string"
-            }
-          },
           {
             "in": "query",
             "name": "launch",
-            "required": false,
             "schema": {
               "description": "Launch options, which can be either an object\nof puppeteer.launch options or playwright.launchServer\noptions, depending on the API. Must be either JSON\nobject, or a base64-encoded JSON object.",
               "anyOf": [
-                {
-                  "$ref": "#/definitions/CDPLaunchOptions"
-                },
                 {
                   "$ref": "#/definitions/BrowserServerOptions"
                 },
@@ -8237,16 +8071,22 @@
           {
             "in": "query",
             "name": "timeout",
-            "required": false,
             "schema": {
               "description": "Override the system-level timeout for this request.\nAccepts a value in milliseconds.",
               "type": "number"
             }
           },
+          {
+            "in": "query",
+            "name": "token",
+            "schema": {
+              "description": "The authorization token",
+              "type": "string"
+            }
+          },
           {
             "in": "query",
             "name": "trackingId",
-            "required": false,
             "schema": {
               "description": "Custom session identifier",
               "type": "string"
@@ -8257,6 +8097,9 @@
           "content": {}
         },
         "responses": {
+          "101": {
+            "description": "Indicates successful WebSocket upgrade."
+          },
           "400": {
             "code": 400,
             "description": "The request contains errors or didn't properly encode content.",
@@ -8288,80 +8131,71 @@
             "message": "HTTP/1.1 500 Internal Server Error"
           }
         },
-        "summary": "/kill/+([0-9a-zA-Z-_])",
+        "summary": "/chrome/playwright",
         "tags": [
-          "Management REST APIs"
+          "Browser WebSocket APIs"
         ]
       }
     },
-    "/meta": {
+    " /chromium": {
       "get": {
         "definitions": {},
-        "description": "Returns a JSON payload of the current system versions, including the core API version.",
-        "parameters": [],
+        "description": "Launch and connect to Chromium with a library like puppeteer or others that work over chrome-devtools-protocol.",
+        "parameters": [
+          {
+            "in": "query",
+            "name": "blockAds",
+            "schema": {
+              "description": "Whether or nor to load ad-blocking extensions for the session.\nThis currently uses uBlock-Lite and may cause certain sites\nto not load properly.",
+              "type": "boolean"
+            }
+          },
+          {
+            "in": "query",
+            "name": "launch",
+            "schema": {
+              "description": "Launch options, which can be either an object\nof puppeteer.launch options or playwright.launchServer\noptions, depending on the API. Must be either JSON\nobject, or a base64-encoded JSON object.",
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/CDPLaunchOptions"
+                },
+                {
+                  "type": "string"
+                }
+              ]
+            }
+          },
+          {
+            "in": "query",
+            "name": "timeout",
+            "schema": {
+              "description": "Override the system-level timeout for this request.\nAccepts a value in milliseconds.",
+              "type": "number"
+            }
+          },
+          {
+            "in": "query",
+            "name": "token",
+            "schema": {
+              "description": "The authorization token",
+              "type": "string"
+            }
+          },
+          {
+            "in": "query",
+            "name": "trackingId",
+            "schema": {
+              "description": "Custom session identifier",
+              "type": "string"
+            }
+          }
+        ],
         "requestBody": {
           "content": {}
         },
         "responses": {
-          "200": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "type": "object",
-                  "properties": {
-                    "version": {
-                      "description": "The semantic version of the Browserless API",
-                      "type": "string"
-                    },
-                    "chromium": {
-                      "description": "The version of Chromium installed, or null if not installed",
-                      "type": [
-                        "null",
-                        "string"
-                      ]
-                    },
-                    "webkit": {
-                      "description": "The version of Webkit installed, or null if not installed",
-                      "type": [
-                        "null",
-                        "string"
-                      ]
-                    },
-                    "firefox": {
-                      "description": "The version of Firefox installed, or null if not installed",
-                      "type": [
-                        "null",
-                        "string"
-                      ]
-                    },
-                    "playwright": {
-                      "description": "The supported version(s) of puppeteer",
-                      "type": "array",
-                      "items": {
-                        "type": "string"
-                      }
-                    },
-                    "puppeteer": {
-                      "description": "The supported version(s) of playwright",
-                      "type": "array",
-                      "items": {
-                        "type": "string"
-                      }
-                    }
-                  },
-                  "additionalProperties": false,
-                  "required": [
-                    "chromium",
-                    "firefox",
-                    "playwright",
-                    "puppeteer",
-                    "version",
-                    "webkit"
-                  ],
-                  "$schema": "http://json-schema.org/draft-07/schema#"
-                }
-              }
-            }
+          "101": {
+            "description": "Indicates successful WebSocket upgrade."
           },
           "400": {
             "code": 400,
@@ -8394,67 +8228,72 @@
             "message": "HTTP/1.1 500 Internal Server Error"
           }
         },
-        "summary": "/meta",
+        "summary": " /chromium",
         "tags": [
-          "Management REST APIs"
+          "Browser WebSocket APIs"
         ]
       }
     },
-    "/metrics/total": {
+    "/playwright/chromium /chromium/playwright": {
       "get": {
         "definitions": {},
-        "description": "Gets total metric details summed from the time the server started.",
-        "parameters": [],
-        "requestBody": {
-          "content": {}
-        },
-        "responses": {
-          "400": {
-            "code": 400,
-            "description": "The request contains errors or didn't properly encode content.",
-            "message": "HTTP/1.1 400 Bad Request"
-          },
-          "401": {
-            "code": 401,
-            "description": "The request is missing, or contains bad, authorization credentials.",
-            "message": "HTTP/1.1 401 Unauthorized"
+        "description": "Connect to Chromium with any playwright style library.",
+        "parameters": [
+          {
+            "in": "query",
+            "name": "blockAds",
+            "schema": {
+              "description": "Whether or nor to load ad-blocking extensions for the session.\nThis currently uses uBlock-Lite and may cause certain sites\nto not load properly.",
+              "type": "boolean"
+            }
           },
-          "404": {
-            "code": 404,
-            "description": "Resource couldn't be found.",
-            "message": "HTTP/1.1 404 Not Found"
+          {
+            "in": "query",
+            "name": "launch",
+            "schema": {
+              "description": "Launch options, which can be either an object\nof puppeteer.launch options or playwright.launchServer\noptions, depending on the API. Must be either JSON\nobject, or a base64-encoded JSON object.",
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/BrowserServerOptions"
+                },
+                {
+                  "type": "string"
+                }
+              ]
+            }
           },
-          "408": {
-            "code": 408,
-            "description": "The request took has taken too long to process.",
-            "message": "HTTP/1.1 408 Request Timeout"
+          {
+            "in": "query",
+            "name": "timeout",
+            "schema": {
+              "description": "Override the system-level timeout for this request.\nAccepts a value in milliseconds.",
+              "type": "number"
+            }
           },
-          "429": {
-            "code": 429,
-            "description": "Too many requests are currently being processed.",
-            "message": "HTTP/1.1 429 Too Many Requests"
+          {
+            "in": "query",
+            "name": "token",
+            "schema": {
+              "description": "The authorization token",
+              "type": "string"
+            }
           },
-          "500": {
-            "code": 500,
-            "description": "An internal error occurred when handling the request.",
-            "message": "HTTP/1.1 500 Internal Server Error"
+          {
+            "in": "query",
+            "name": "trackingId",
+            "schema": {
+              "description": "Custom session identifier",
+              "type": "string"
+            }
           }
-        },
-        "summary": "/metrics/total",
-        "tags": [
-          "Management REST APIs"
-        ]
-      }
-    },
-    "/metrics": {
-      "get": {
-        "definitions": {},
-        "description": "Returns a list of metric details as far back as possible.",
-        "parameters": [],
+        ],
         "requestBody": {
           "content": {}
         },
         "responses": {
+          "101": {
+            "description": "Indicates successful WebSocket upgrade."
+          },
           "400": {
             "code": 400,
             "description": "The request contains errors or didn't properly encode content.",
@@ -8486,21 +8325,72 @@
             "message": "HTTP/1.1 500 Internal Server Error"
           }
         },
-        "summary": "/metrics",
+        "summary": "/playwright/chromium /chromium/playwright",
         "tags": [
-          "Management REST APIs"
+          "Browser WebSocket APIs"
         ]
       }
     },
-    "/pressure": {
+    "/edge": {
       "get": {
         "definitions": {},
-        "description": "Returns a JSON body of stats related to the pressure being created on the instance.",
-        "parameters": [],
+        "description": "Launch and connect to Chromium with a library like puppeteer or others that work over chrome-devtools-protocol.",
+        "parameters": [
+          {
+            "in": "query",
+            "name": "blockAds",
+            "schema": {
+              "description": "Whether or nor to load ad-blocking extensions for the session.\nThis currently uses uBlock-Lite and may cause certain sites\nto not load properly.",
+              "type": "boolean"
+            }
+          },
+          {
+            "in": "query",
+            "name": "launch",
+            "schema": {
+              "description": "Launch options, which can be either an object\nof puppeteer.launch options or playwright.launchServer\noptions, depending on the API. Must be either JSON\nobject, or a base64-encoded JSON object.",
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/CDPLaunchOptions"
+                },
+                {
+                  "type": "string"
+                }
+              ]
+            }
+          },
+          {
+            "in": "query",
+            "name": "timeout",
+            "schema": {
+              "description": "Override the system-level timeout for this request.\nAccepts a value in milliseconds.",
+              "type": "number"
+            }
+          },
+          {
+            "in": "query",
+            "name": "token",
+            "schema": {
+              "description": "The authorization token",
+              "type": "string"
+            }
+          },
+          {
+            "in": "query",
+            "name": "trackingId",
+            "schema": {
+              "description": "Custom session identifier",
+              "type": "string"
+            }
+          }
+        ],
         "requestBody": {
           "content": {}
         },
         "responses": {
+          "101": {
+            "description": "Indicates successful WebSocket upgrade."
+          },
           "400": {
             "code": 400,
             "description": "The request contains errors or didn't properly encode content.",
@@ -8532,30 +8422,20 @@
             "message": "HTTP/1.1 500 Internal Server Error"
           }
         },
-        "summary": "/pressure",
+        "summary": "/edge",
         "tags": [
-          "Management REST APIs"
+          "Browser WebSocket APIs"
         ]
       }
     },
-    "/sessions": {
+    "/edge/playwright": {
       "get": {
         "definitions": {},
-        "description": "Lists all currently running sessions and relevant meta-data excluding potentially open pages.",
+        "description": "Connect to Chromium with any playwright style library.",
         "parameters": [
-          {
-            "in": "query",
-            "name": "token",
-            "required": true,
-            "schema": {
-              "description": "The authorization token",
-              "type": "string"
-            }
-          },
           {
             "in": "query",
             "name": "blockAds",
-            "required": false,
             "schema": {
               "description": "Whether or nor to load ad-blocking extensions for the session.\nThis currently uses uBlock-Lite and may cause certain sites\nto not load properly.",
               "type": "boolean"
@@ -8564,13 +8444,9 @@
           {
             "in": "query",
             "name": "launch",
-            "required": false,
             "schema": {
               "description": "Launch options, which can be either an object\nof puppeteer.launch options or playwright.launchServer\noptions, depending on the API. Must be either JSON\nobject, or a base64-encoded JSON object.",
               "anyOf": [
-                {
-                  "$ref": "#/definitions/CDPLaunchOptions"
-                },
                 {
                   "$ref": "#/definitions/BrowserServerOptions"
                 },
@@ -8583,16 +8459,22 @@
           {
             "in": "query",
             "name": "timeout",
-            "required": false,
             "schema": {
               "description": "Override the system-level timeout for this request.\nAccepts a value in milliseconds.",
               "type": "number"
             }
           },
+          {
+            "in": "query",
+            "name": "token",
+            "schema": {
+              "description": "The authorization token",
+              "type": "string"
+            }
+          },
           {
             "in": "query",
             "name": "trackingId",
-            "required": false,
             "schema": {
               "description": "Custom session identifier",
               "type": "string"
@@ -8603,6 +8485,9 @@
           "content": {}
         },
         "responses": {
+          "101": {
+            "description": "Indicates successful WebSocket upgrade."
+          },
           "400": {
             "code": 400,
             "description": "The request contains errors or didn't properly encode content.",
@@ -8634,21 +8519,136 @@
             "message": "HTTP/1.1 500 Internal Server Error"
           }
         },
-        "summary": "/sessions",
+        "summary": "/edge/playwright",
         "tags": [
-          "Management REST APIs"
+          "Browser WebSocket APIs"
         ]
       }
     },
-    "/": {
+    "/playwright/firefox /firefox/playwright": {
       "get": {
         "definitions": {},
-        "description": "Serves static files inside of this \"static\" directory. Content-types will vary depending on the type =of file being returned.",
-        "parameters": [],
+        "description": "Connect to Firefox with any playwright-compliant library.",
+        "parameters": [
+          {
+            "in": "query",
+            "name": "blockAds",
+            "schema": {
+              "description": "Whether or nor to load ad-blocking extensions for the session.\nThis currently uses uBlock-Lite and may cause certain sites\nto not load properly.",
+              "type": "boolean"
+            }
+          },
+          {
+            "in": "query",
+            "name": "launch",
+            "schema": {
+              "description": "Launch options, which can be either an object\nof puppeteer.launch options or playwright.launchServer\noptions, depending on the API. Must be either JSON\nobject, or a base64-encoded JSON object.",
+              "additionalProperties": false,
+              "type": "object",
+              "properties": {
+                "args": {
+                  "type": "array",
+                  "items": {
+                    "type": "string"
+                  }
+                },
+                "chromiumSandbox": {
+                  "type": "boolean"
+                },
+                "devtools": {
+                  "type": "boolean"
+                },
+                "downloadsPath": {
+                  "type": "string"
+                },
+                "headless": {
+                  "type": "boolean"
+                },
+                "ignoreDefaultArgs": {
+                  "anyOf": [
+                    {
+                      "type": "array",
+                      "items": {
+                        "type": "string"
+                      }
+                    },
+                    {
+                      "type": "boolean"
+                    }
+                  ]
+                },
+                "proxy": {
+                  "type": "object",
+                  "properties": {
+                    "bypass": {
+                      "type": "string"
+                    },
+                    "password": {
+                      "type": "string"
+                    },
+                    "server": {
+                      "type": "string"
+                    },
+                    "username": {
+                      "type": "string"
+                    }
+                  },
+                  "additionalProperties": false,
+                  "required": [
+                    "server"
+                  ]
+                },
+                "timeout": {
+                  "type": "number"
+                },
+                "tracesDir": {
+                  "type": "string"
+                },
+                "firefoxUserPrefs": {
+                  "type": "object",
+                  "additionalProperties": {
+                    "type": [
+                      "string",
+                      "number",
+                      "boolean"
+                    ]
+                  }
+                }
+              }
+            }
+          },
+          {
+            "in": "query",
+            "name": "timeout",
+            "schema": {
+              "description": "Override the system-level timeout for this request.\nAccepts a value in milliseconds.",
+              "type": "number"
+            }
+          },
+          {
+            "in": "query",
+            "name": "token",
+            "schema": {
+              "description": "The authorization token",
+              "type": "string"
+            }
+          },
+          {
+            "in": "query",
+            "name": "trackingId",
+            "schema": {
+              "description": "Custom session identifier",
+              "type": "string"
+            }
+          }
+        ],
         "requestBody": {
           "content": {}
         },
         "responses": {
+          "101": {
+            "description": "Indicates successful WebSocket upgrade."
+          },
           "400": {
             "code": 400,
             "description": "The request contains errors or didn't properly encode content.",
@@ -8680,9 +8680,9 @@
             "message": "HTTP/1.1 500 Internal Server Error"
           }
         },
-        "summary": "/",
+        "summary": "/playwright/firefox /firefox/playwright",
         "tags": [
-          "Management REST APIs"
+          "Browser WebSocket APIs"
         ]
       }
     },