--- title: "Changes to Create a session" method: POST path: "/v1/browser_sessions" --- # Changes to Create a session `POST /v1/browser_sessions` > Every recorded change to this endpoint, newest first. ## Timeline Changed in 11 of 86 revisions. - **2026-08-20** `701729837d27` — 1 info - **2026-08-19** `938b4f124550` — 1 info - **2026-08-07** `9585bc129aaf` — 1 info - **2026-08-02** `f15b01f742d3` — 2 info - **2026-08-02** `6d9eef3774fe` — 1 info - **2026-07-30** `4f040669f151` — 1 warning - **2026-07-29** `41e65a8c4f59` — 1 info - **2026-06-26** `9de266eb002a` — 1 info - **2026-06-12** `7ce5e3e9a560` — 3 info - **2026-06-08** `3a3616091b66` — 48 breaking, 14 info - **2026-02-04** `a8899e7707c4` — 1 info ## Changes - **2026-08-20** `701729837d27` — 1 info - added the optional property `warning` to the response with the `200` status - **2026-08-19** `938b4f124550` — 1 info - added the non-success response with the status `400` - **2026-08-07** `9585bc129aaf` — 1 info - added the optional property `stream_transport` to the response with the `200` status - **2026-08-02** `f15b01f742d3` — 2 info - added the new optional request property `needs_live_view` - the request body `application/json` default value changed from `{"timeout":60,"generate_browser_profile":false}` to `{"timeout":60,"generate_browser_profile":false,"needs_live_view":false}` - **2026-08-02** `6d9eef3774fe` — 1 info - added the new optional request property `url` - **2026-07-30** `4f040669f151` — 1 warning - removed the request property `url` - **2026-07-29** `41e65a8c4f59` — 1 info - added the new optional request property `url` - **2026-06-26** `9de266eb002a` — 1 info - added the new optional request property `proxy_session_id` - **2026-06-12** `7ce5e3e9a560` — 3 info - added the new optional request property `generate_browser_profile` - the request body `application/json` default value changed from `{"timeout":60}` to `{"timeout":60,"generate_browser_profile":false}` - added the optional property `generate_browser_profile` to the response with the `200` status - **2026-06-08** `3a3616091b66` — 48 breaking, 14 info - the request property `browser_type` became not nullable - the request property `extensions` became not nullable - the request property `proxy_location` became not nullable - the request property `timeout` became not nullable - removed the enum value `NONE` of the request property `proxy_location` - removed the enum value `RESIDENTIAL` of the request property `proxy_location` - removed the enum value `RESIDENTIAL_AR` of the request property `proxy_location` - removed the enum value `RESIDENTIAL_AU` of the request property `proxy_location` - removed the enum value `RESIDENTIAL_BR` of the request property `proxy_location` - removed the enum value `RESIDENTIAL_CA` of the request property `proxy_location` - removed the enum value `RESIDENTIAL_DE` of the request property `proxy_location` - removed the enum value `RESIDENTIAL_ES` of the request property `proxy_location` - removed the enum value `RESIDENTIAL_FR` of the request property `proxy_location` - removed the enum value `RESIDENTIAL_GB` of the request property `proxy_location` - removed the enum value `RESIDENTIAL_IE` of the request property `proxy_location` - removed the enum value `RESIDENTIAL_IN` of the request property `proxy_location` - removed the enum value `RESIDENTIAL_ISP` of the request property `proxy_location` - removed the enum value `RESIDENTIAL_IT` of the request property `proxy_location` - removed the enum value `RESIDENTIAL_JP` of the request property `proxy_location` - removed the enum value `RESIDENTIAL_MX` of the request property `proxy_location` - removed the enum value `RESIDENTIAL_NL` of the request property `proxy_location` - removed the enum value `RESIDENTIAL_NZ` of the request property `proxy_location` - removed the enum value `RESIDENTIAL_PH` of the request property `proxy_location` - removed the enum value `RESIDENTIAL_TR` of the request property `proxy_location` - removed the enum value `RESIDENTIAL_ZA` of the request property `proxy_location` - removed the enum value `US-CA` of the request property `proxy_location` - removed the enum value `US-FL` of the request property `proxy_location` - removed the enum value `US-NY` of the request property `proxy_location` - removed the enum value `US-TX` of the request property `proxy_location` - removed the enum value `US-WA` of the request property `proxy_location` - removed the enum value `chrome` of the request property `browser_type` - removed the enum value `msedge` of the request property `browser_type` - the `browser_type` request property type changed from `string` to no type - the `proxy_location` request property type changed from `string` to no type - response property `app_url` list-of-types was widened by adding types `null` to media type `application/json` of response `200` - response property `browser_address` list-of-types was widened by adding types `null` to media type `application/json` of response `200` - response property `completed_at` list-of-types was widened by adding types `null` to media type `application/json` of response `200` - response property `deleted_at` list-of-types was widened by adding types `null` to media type `application/json` of response `200` - response property `download_path` list-of-types was widened by adding types `null` to media type `application/json` of response `200` - response property `downloaded_files` list-of-types was widened by adding types `null` to media type `application/json` of response `200` - …22 more - **2026-02-04** `a8899e7707c4` — 1 info - endpoint added --- [Operation](https://skmtc.dev/skyvern-ai/apis/skyvern-api-2/docs/v1/browser_sessions/post.md) · [API](https://skmtc.dev/skyvern-ai/apis/skyvern-api-2.md) · [Page](https://skmtc.dev/skyvern-ai/apis/skyvern-api-2/changes/v1/browser_sessions/post)