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

# Update a Session

`POST /v1/sessions/{id}`

## Path parameters

- `id` string, required

## Request body

- object
  - `projectId` string — The Project ID. Can be found in [Settings](https://www.browserbase.com/settings). Optional - if not provided, the project will be inferred from the API key.
  - `status` 'REQUEST_RELEASE', required — Set to `REQUEST_RELEASE` to request that the session complete. Use before session's timeout to avoid additional charges.

## Response `200`

The request has succeeded.

- Session
  - `id` string, required
  - `createdAt` string, date-time, required
  - `updatedAt` string, date-time, required
  - `projectId` string, required — The Project ID linked to the Session.
  - `startedAt` string, date-time, required
  - `endedAt` string, date-time
  - `expiresAt` string, date-time, required
  - `status` 'PENDING' | 'RUNNING' | 'ERROR' | 'TIMED_OUT' | 'COMPLETED', required
  - `proxyBytes` integer, required — Bytes used via the [Proxy](/features/stealth-mode#proxies-and-residential-ips)
  - `keepAlive` boolean, required — Indicates if the Session was created to be kept alive upon disconnections
  - `contextId` string — Optional. The Context linked to the Session.
  - `region` 'us-west-2' | 'us-east-1' | 'eu-central-1' | 'ap-southeast-1', required — The region where the Session is running.
  - `userMetadata` object — Arbitrary user metadata to attach to the session. To learn more about user metadata, see [User Metadata](/features/sessions#user-metadata).

## Changes

- **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/format changed from ``/`` to `string`/``
  - the `contextId` response's property type/format changed from ``/`` to `string`/`` for status `200`
  - the `projectId` response's property type/format changed from ``/`` to `string`/`` for status `200`
  - the `region` response's property type/format changed from ``/`` to `string`/`` for status `200`
  - …11 more
- **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

[Full history](https://skmtc.dev/browserbase/apis/browserbase-api/changes/v1/sessions/:id/post.md)

---

[API](https://skmtc.dev/browserbase/apis/browserbase-api.md) · [All operations](https://skmtc.dev/browserbase/apis/browserbase-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/browserbase/browserbase-api/revisions/550634919db9/schema)