---
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 operation, newest first.

## Timeline

Changed in 14 of 79 revisions.

- **2026-10-20** `89fc67079375`: 2 warning
- **2026-10-19** `7b0a0c6ac6c7`: 2 info
- **2026-10-08** `04df18172f4d`: 10 info
- **2026-08-02** `7024de9949d2`: 1 info
- **2026-07-30** `645819945b7b`: 1 warning
- **2026-07-29** `0cff90865ea3`: 1 info
- **2026-07-14** `1b9c7c96c010`: 1 info
- **2026-07-14** `66da0fa97dc5`: 1 warning
- **2026-07-14** `1b9c7c96c010`: 1 info
- **2026-06-13** `e7044f43e57e`: 3 info
- **2026-05-09** `9a8565aaedbf`: 6 info
- **2026-05-09** `f97d3f2efafe`: 2 breaking, 4 warning
- **2026-05-09** `9a8565aaedbf`: 6 info
- **2026-03-21** `458f1f2bbd45`: 1 warning, 1 info

## Changes

- **2026-10-20** `89fc67079375`: 2 warning
  - removed the optional property `remaining_lifetime_seconds` from the response with the `200` status
  - removed the optional property `source` from the response with the `200` status
- **2026-10-19** `7b0a0c6ac6c7`: 2 info
  - added the optional property `remaining_lifetime_seconds` to the response with the `200` status
  - added the optional property `source` to the response with the `200` status
- **2026-10-08** `04df18172f4d`: 10 info
  - added the new optional request property `browser_settings`
  - added the new optional request property `needs_live_view`
  - added the new optional request property `proxy_location/anyOf[subschema #2: GeoTarget]/isISP`
  - 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}`
  - added the non-success response with the status `400`
  - added the optional property `browser_settings` to the response with the `200` status
  - added the optional property `browser_settings_receipt` to the response with the `200` status
  - added the optional property `created_by` to the response with the `200` status
  - added the optional property `stream_transport` to the response with the `200` status
  - added the optional property `warning` to the response with the `200` status
- **2026-08-02** `7024de9949d2`: 1 info
  - added the new optional request property `url`
- **2026-07-30** `645819945b7b`: 1 warning
  - removed the request property `url`
- **2026-07-29** `0cff90865ea3`: 1 info
  - added the new optional request property `url`
- **2026-07-14** `1b9c7c96c010`: 1 info
  - added the new optional request property `proxy_session_id`
- **2026-07-14** `66da0fa97dc5`: 1 warning
  - removed the request property `proxy_session_id`
- **2026-07-14** `1b9c7c96c010`: 1 info
  - added the new optional request property `proxy_session_id`
- **2026-06-13** `e7044f43e57e`: 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-05-09** `9a8565aaedbf`: 6 info
  - added `#/components/schemas/GeoTarget, subschema #3` to the `proxy_location` request property `anyOf` list
  - added the new `RESIDENTIAL_SA` enum value to the request property `proxy_location/anyOf[subschema #1: ProxyLocation]/`
  - added the optional property `downloaded_files/anyOf[subschema #1]/items/artifact_id` to the response with the `200` status
  - added the optional property `downloaded_files/anyOf[subschema #1]/items/file_size` to the response with the `200` status
  - added the optional property `recordings/anyOf[subschema #1]/items/artifact_id` to the response with the `200` status
  - added the optional property `recordings/anyOf[subschema #1]/items/file_size` to the response with the `200` status
- **2026-05-09** `f97d3f2efafe`: 2 breaking, 4 warning
  - removed `#/components/schemas/GeoTarget, subschema #3` from the `proxy_location` request property `anyOf` list
  - removed the enum value `RESIDENTIAL_SA` of the request property `proxy_location/anyOf[subschema #1: ProxyLocation]/`
  - removed the optional property `downloaded_files/anyOf[subschema #1]/items/artifact_id` from the response with the `200` status
  - removed the optional property `downloaded_files/anyOf[subschema #1]/items/file_size` from the response with the `200` status
  - removed the optional property `recordings/anyOf[subschema #1]/items/artifact_id` from the response with the `200` status
  - removed the optional property `recordings/anyOf[subschema #1]/items/file_size` from the response with the `200` status
- **2026-05-09** `9a8565aaedbf`: 6 info
  - added `#/components/schemas/GeoTarget, subschema #3` to the `proxy_location` request property `anyOf` list
  - added the new `RESIDENTIAL_SA` enum value to the request property `proxy_location/anyOf[subschema #1: ProxyLocation]/`
  - added the optional property `downloaded_files/anyOf[subschema #1]/items/artifact_id` to the response with the `200` status
  - added the optional property `downloaded_files/anyOf[subschema #1]/items/file_size` to the response with the `200` status
  - added the optional property `recordings/anyOf[subschema #1]/items/artifact_id` to the response with the `200` status
  - added the optional property `recordings/anyOf[subschema #1]/items/file_size` to the response with the `200` status
- **2026-03-21** `458f1f2bbd45`: 1 warning, 1 info
  - added the new `stealth-chromium` enum value to the `browser_type/anyOf[subschema #1: PersistentBrowserType]/` response property for the response status `200`
  - added the new `stealth-chromium` enum value to the request property `browser_type/anyOf[subschema #1: PersistentBrowserType]/`

---

[Operation](https://skmtc.dev/skyvern-ai/apis/skyvern-api/docs/v1/browser_sessions/post.md) - [API](https://skmtc.dev/skyvern-ai/apis/skyvern-api.md) - [Page](https://skmtc.dev/skyvern-ai/apis/skyvern-api/changes/v1/browser_sessions/post)