---
title: "Changes to Update a Session"
method: POST
path: "/v1/sessions/{id}"
---

# Changes to Update a Session

`POST /v1/sessions/{id}`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 10 of 45 revisions.

- **2026-10-16** `266d5199a560`: 1 warning
- **2026-05-13** `3cb839210d89`: 1 warning
- **2026-02-26** `a2379f6bf614`: 4 breaking, 7 warning, 4 info
- **2025-01-28** `396a2b9092f6`: 1 info
- **2024-10-27** `b37d85811d1c`: 4 info
- **2024-10-27** `0d0ad7d4de2f`: 1 info
- **2024-10-27** `0069ed71133a`: 8 breaking, 10 warning, 9 info
- **2024-10-27** `69e3c041b63e`: 1 warning, 1 info
- **2024-10-26** `208ded3468d1`: 7 breaking, 4 warning, 18 info
- **2024-10-25** `825ce446567d`: 4 info

## Changes

- **2026-10-16** `266d5199a560`: 1 warning
  - removed the request property `projectId`
- **2026-05-13** `3cb839210d89`: 1 warning
  - added the new `PENDING` enum value to the `status` response property for the response status `200`
- **2026-02-26** `a2379f6bf614`: 4 breaking, 7 warning, 4 info
  - the `projectId` request property type changed from no type to `string`
  - the `contextId` response's property type changed from no type to `string` for status `200`
  - the `projectId` response's property type changed from no type to `string` for status `200`
  - the `region` response's property type changed from no type to `string` for status `200`
  - removed `#/components/schemas/uuid` from the `projectId` request property `allOf` list
  - removed the optional property `avgCpuUsage` from the response with the `200` status
  - removed the optional property `memoryUsage` from the response with the `200` status
  - added the new `ap-southeast-1` enum value to the `region` response property for the response status `200`
  - added the new `eu-central-1` enum value to the `region` response property for the response status `200`
  - added the new `us-east-1` enum value to the `region` response property for the response status `200`
  - added the new `us-west-2` enum value to the `region` response property for the response status `200`
  - the request property `projectId` became optional
  - removed `#/components/schemas/Region` from the `region` response property `allOf` list for the response status `200`
  - removed `#/components/schemas/uuid` from the `contextId` response property `allOf` list for the response status `200`
  - removed `#/components/schemas/uuid` from the `projectId` response property `allOf` list for the response status `200`
- **2025-01-28** `396a2b9092f6`: 1 info
  - added the optional property `userMetadata` to the response with the `200` status
- **2024-10-27** `b37d85811d1c`: 4 info
  - removed `#/components/schemas/Entity` from the response body `allOf` list for the response status `200`
  - added the required property `createdAt` to the response with the `200` status
  - added the required property `id` to the response with the `200` status
  - added the required property `updatedAt` to the response with the `200` status
- **2024-10-27** `0d0ad7d4de2f`: 1 info
  - added the required property `region` to the response with the `200` status
- **2024-10-27** `0069ed71133a`: 8 breaking, 10 warning, 9 info
  - removed the required property `created_at` from the response with the `200` status
  - removed the required property `expires_at` from the response with the `200` status
  - removed the required property `id` from the response with the `200` status
  - removed the required property `keep_alive` from the response with the `200` status
  - removed the required property `project_id` from the response with the `200` status
  - removed the required property `region` from the response with the `200` status
  - removed the required property `started_at` from the response with the `200` status
  - removed the required property `updated_at` from the response with the `200` status
  - removed the optional property `avg_cpu_usage` from the response with the `200` status
  - removed the optional property `connectUrl` from the response with the `200` status
  - removed the optional property `context_id` from the response with the `200` status
  - removed the optional property `ended_at` from the response with the `200` status
  - removed the optional property `is_idle` from the response with the `200` status
  - removed the optional property `memory_usage` from the response with the `200` status
  - removed the optional property `seleniumRemoteUrl` from the response with the `200` status
  - removed the optional property `signingKey` from the response with the `200` status
  - removed the optional property `viewport_height` from the response with the `200` status
  - removed the optional property `viewport_width` from the response with the `200` status
  - added `#/components/schemas/Entity` to the response body `allOf` list for the response status `200`
  - added the optional property `avgCpuUsage` to the response with the `200` status
  - added the optional property `contextId` to the response with the `200` status
  - added the optional property `endedAt` to the response with the `200` status
  - added the optional property `memoryUsage` to the response with the `200` status
  - added the required property `expiresAt` to the response with the `200` status
  - added the required property `keepAlive` to the response with the `200` status
  - added the required property `projectId` to the response with the `200` status
  - added the required property `startedAt` to the response with the `200` status
- **2024-10-27** `69e3c041b63e`: 1 warning, 1 info
  - removed the optional property `proxy_bytes` from the response with the `200` status
  - added the required property `proxyBytes` to the response with the `200` status
- **2024-10-26** `208ded3468d1`: 7 breaking, 4 warning, 18 info
  - removed the required property `createdAt` from the response with the `200` status
  - removed the required property `expiresAt` from the response with the `200` status
  - removed the required property `keepAlive` from the response with the `200` status
  - removed the required property `projectId` from the response with the `200` status
  - removed the required property `proxyBytes` from the response with the `200` status
  - removed the required property `startedAt` from the response with the `200` status
  - removed the required property `updatedAt` from the response with the `200` status
  - removed the optional property `avgCpuUsage` from the response with the `200` status
  - removed the optional property `contextId` from the response with the `200` status
  - removed the optional property `endedAt` from the response with the `200` status
  - removed the optional property `memoryUsage` from the response with the `200` status
  - added the optional property `avg_cpu_usage` to the response with the `200` status
  - added the optional property `connectUrl` to the response with the `200` status
  - added the optional property `context_id` to the response with the `200` status
  - added the optional property `ended_at` to the response with the `200` status
  - added the optional property `is_idle` to the response with the `200` status
  - added the optional property `memory_usage` to the response with the `200` status
  - added the optional property `proxy_bytes` to the response with the `200` status
  - added the optional property `seleniumRemoteUrl` to the response with the `200` status
  - added the optional property `signingKey` to the response with the `200` status
  - added the optional property `viewport_height` to the response with the `200` status
  - added the optional property `viewport_width` to the response with the `200` status
  - added the required property `created_at` to the response with the `200` status
  - added the required property `expires_at` to the response with the `200` status
  - added the required property `keep_alive` to the response with the `200` status
  - added the required property `project_id` to the response with the `200` status
  - added the required property `region` to the response with the `200` status
  - added the required property `started_at` to the response with the `200` status
  - added the required property `updated_at` to the response with the `200` status
- **2024-10-25** `825ce446567d`: 4 info
  - removed `#/components/schemas/Entity` from the response body `allOf` list for the response status `200`
  - added the required property `createdAt` to the response with the `200` status
  - added the required property `id` to the response with the `200` status
  - added the required property `updatedAt` to the response with the `200` status

---

[Operation](https://skmtc.dev/browserbase/apis/browserbase-api/docs/v1/sessions/:id/post.md) - [API](https://skmtc.dev/browserbase/apis/browserbase-api.md) - [Page](https://skmtc.dev/browserbase/apis/browserbase-api/changes/v1/sessions/:id/post)
