> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cake.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Rename sessions

> Give a session a clearer title from the sidebar or the session header, and see rename events in the conversation timeline.

Every session starts with an auto-generated title. Rename it whenever the default doesn't reflect the work you're actually doing. A good title makes sessions easier to find in the sidebar and easier for teammates to recognize.

## Who can rename a session

* The user who created the session.
* Any user with the **admin** role.

Everyone else sees the title as read-only.

## Rename from the session header

1. Open the session.
2. Select the pencil icon next to the title.
3. Edit the title inline. Press **Enter** to save or **Escape** to cancel.

## Rename from the sidebar

1. Hover the session in the sidebar and open its menu (the ⋯ icon).
2. Select **Rename**.
3. Enter a new title in the modal and confirm.

## Title rules

* Titles must be between 1 and 50 characters.
* Leading and trailing whitespace is trimmed.
* Once you set a custom title, Cake stops overwriting it with auto-generated titles from the agent.

## Rename events in the conversation

Every rename is recorded as an event in the conversation timeline, showing the previous title, the new title, and who made the change. This makes it easy to see how a session's focus evolved and who reframed it.

Rename events also stream to anyone viewing the session, so titles update live in the sidebar and header without a refresh.

## Rename through the API

You can also rename a session with a `PATCH` to the session endpoint:

```http theme={null}
PATCH /api/sessions/{sessionId}
Content-Type: application/json

{
  "title": "Investigate auth flow"
}
```

The same permission rules apply: the caller must own the session or hold the admin role. A successful rename returns `204 No Content`; sending the current title returns `400 No changes made`; a caller without permission gets `403 Forbidden`.