Skip to main content
Private sessions are visible only to their owner. Public sessions remain visible to everyone in your organization. Use private sessions when you’re exploring sensitive code paths, drafting work you don’t want to share yet, or experimenting in a personal scratch space.

​
When to use private sessions

  • You’re working on something that isn’t ready for teammates to see.
  • The session involves sensitive repositories, credentials, or customer data.
  • You want a personal scratch space without cluttering the shared sidebar.
For collaborative work (code reviews, pair sessions, anything you want teammates to jump into), leave the session public.

​
Create a private session

​
From the web UI

  1. Go to New session.
  2. Toggle Private before submitting.
  3. Create the session.
A lock icon next to the session title indicates it’s private; a globe icon indicates it’s public.

​
From Slack

New Slack threads and Slack agent direct messages can have different default visibility. When a Slack conversation starts a new Cake session, it uses the default for that conversation type. You can also set visibility through the API when creating a session: 
POST /api/sessions
Content-Type: application/json

{
  "title": "Investigate auth flow",
  "private": true,
  "initialUserPrompt": "Walk me through the login handshake"
}
The private field is required on session creation. Set it to true for a private session or false for a public one.

​
Filter sessions in the sidebar

The sidebar can show public sessions, private sessions, or both.
  • Use the visibility filter (globe and lock icons) at the top of the session list to toggle which sessions are displayed.
  • Private sessions you do not own never appear in the list.

​
Set default visibility

You can configure the default visibility for new sessions in Settings → User Settings → Sessions → Privacy. Three defaults are available:
SettingApplies toDefault
Web UISessions started from the New session screenPublic
New Slack threadsSessions started by mentioning the bot or replying in SlackPublic
Slack agent DMsSessions started from the Chat tab in the Slack appPrivate
Each setting has two scopes:
  • Organization default (set by an admin and applied to everyone who hasn’t overridden it).
  • User override (your personal preference, which takes precedence over the org default).
Toggle the switch to flip between public and private. Use the remove control next to a setting to clear your user override and fall back to the organization default.
Slack agent DMs default to private because direct messages are already a one-on-one space. You can change this if your team prefers shared visibility.

​
How visibility is enforced

  • Private sessions are filtered out of session list endpoints for users who don’t own them.
  • The session events stream (GET /api/sessions/events) skips private sessions whose owner isn’t the subscriber.
  • Session detail, message, and action routes return a not-found response for private sessions that don’t belong to the requester.
Changing a session’s owner or visibility after creation isn’t supported. Pick the visibility that fits when you start the session.