Skip to main content
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:
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.