Skip to main content

Personal inbox

Where to find it: Workspace → Inbox (/inbox), Personal view (the default). This is a two-pane screen. You get a list on the left, and the full detail of whatever you select on the right.

What are Needs you and Updates?​

Everything lands in one of two lanes, shown as tabs at the top of the list, each with a count badge:

  • Needs you: things that genuinely require a decision or response from you, such as an approval to make, a question an agent is asking, or an action assigned to you.
  • Updates: informational items, like milestones on something you chose to follow, or the result of a run you asked to be told about. See Following and awaiting results for how items end up here.

The tab you are on is part of the URL (?tab=needs_you or ?tab=updates), so a link into a specific item always opens on the right lane. If a link's tab value is not recognized, the page falls back to Needs you.

Scoping the list​

  • Workspace and project: the Inbox always reflects whatever workspace and project are currently active in the sidebar. It is the same selector, not an Inbox-only setting. Selecting a different project here (via the dropdown next to the tabs) changes your active project everywhere in the app, not just in Inbox.
  • Project dropdown: only shown when the workspace has projects. It lists them by name.
  • Search box: filters the current tab's items by title or preview text, entirely client-side, as you type.

The list (left pane)​

Each row shows you:

  • An unread dot and bolder title text if you have not opened it yet.
  • The title and a two-line preview.
  • A type badge: approval, question, failure, or info.
  • A lane badge: Needs you or Update.
  • How long ago it arrived (relative time).
  • An archive icon (see Archiving items).

Clicking a row opens it in the detail pane, marks it read, and updates the URL to carry the item's id. Once you act on a Needs you item (for example, it gets resolved or cancelled elsewhere), it drops out of the list on the next refresh. If you still have it open, the detail pane instead shows "This notification is no longer active", since it has already been handled and your counts are up to date.

When nothing in the current lane is showing, the empty state reads: "You're all caught up — personal receipts appear here because work was assigned to you or because you chose to follow it."

The detail pane (right side)​

Select an item and the right pane shows:

  • Its type badge, category, lane badge, and how long ago it arrived.
  • Title and preview, followed by the full message body.
  • "Why this is in your Inbox": shown whenever the item carries one or more attention reasons, explaining in plain language why it reached you:
    • "This action is assigned to you." (assigned)
    • "You were mentioned." (mentioned)
    • "A responsibility policy escalated this to you." (escalated to you)
    • "You asked to be notified when this work finished." (awaited result)
    • "You follow this run." / "You follow this card." / "You follow this conversation." (following)
  • Extra context chips when present: severity, status, and region.
  • A link back to whatever triggered the item, when there is one:
    • An issue or card: opens that card.
    • An incident: opens the incident (or, if it no longer exists, a note saying so instead of a dead link).
    • A conversation: opens that chat thread.
    • A deployment: opens that deployment.
    • A pull request: opens that PR.
    • A human-in-the-loop request tied to a card: opens that card (the place to actually respond).
    • Any related issues the item references, as a row of clickable chips.
  • Action buttons, when the item offers any. Today the one live action is Create issue on incident-related items. It creates a follow-up issue straight from the notification without leaving Inbox, and the button becomes a confirmation chip ("Issue created") once done. Other declared actions render as inert labels.

If a resource the item points to (a card or incident) has since been deleted, the pane says so instead of showing a broken link.

Before you have selected anything, the pane shows a neutral "Nothing selected — pick a row on the left to see its context and actions here." prompt.

How does read and unread work?​

  • Opening an item marks it read automatically.
  • Mark all read clears unread status for every item currently in scope (respecting your project filter) in one click, across both lanes.

The header bell​

The Notifications bell in the top header shows the same data, scoped the same way as the Inbox page:

  • An unread-count badge (capped at "9+").
  • A dropdown listing your 6 most recent items, each clickable. Clicking one marks it read and navigates straight into Inbox on the right lane.
  • Its own Mark all read.
  • A View Inbox link at the bottom to the full page.
On this page