---
title: "Update Session"
method: PATCH
path: "/sessions/{session_id}"
tags: ["Sessions"]
---

# Update Session

`PATCH /sessions/{session_id}`

## Request

- Base URL: `https://api.browser-use.com/api/v4`
- URL: `https://api.browser-use.com/api/v4/sessions/{session_id}`
- Auth: API key in header `X-Browser-Use-API-Key`

Rename a session.

`session_title` is denormalized onto every run in the session (the session
list reads the latest run), so a rename writes them all in one UPDATE. Null
clears the name and the UI falls back to the opening task — it does NOT
re-run title generation, which only fills rows where the title IS NULL and
so would silently overwrite the clear.

## Path parameters

- `session_id` string, uuid, required

## Request body

- SessionUpdateRequest: Rename a session. Null clears the user-set name, so the UI falls back to the session's opening task.
  - `title` string, nullable

## Response `200`

Successful Response

- SessionInfo: Lightweight metadata for one V4 session (its most recent run). Deliberately slim — just what a session list needs (open the conversation, show a label + status + time). The heavy per-run fields (result, error, token/cost totals) live on RunSummary and aren't repeated here.
  - `sessionId` string, uuid, required
  - `workspaceId` string, uuid, nullable, required
  - `latestRunId` string, uuid, required
  - `task` string, required
  - `title` string, nullable, required
  - `status` 'queued' | 'dispatching' | 'running' | 'completed' | 'failed' | 'cancelled', required
  - `createdAt` string, date-time, required
  - `updatedAt` string, date-time, required

## Other responses

- `403`: Zero Data Retention is enabled on the project (V4 unsupported).
- `404`: Run, session, workspace, or profile not found.
- `422`: Validation Error

---

[API](https://skmtc.dev/browser-use/apis/browser-use-public-api-v4.md) · [All operations](https://skmtc.dev/browser-use/apis/browser-use-public-api-v4/llms.txt) · [OpenAPI document](https://skmtc.dev/browser-use/apis/browser-use-public-api-v4/revisions/cd7b1eee1102?raw)