---
title: "Get session groups and triage counts"
method: GET
path: "/api/session-tree"
tags: ["Sessions"]
---

# Get session groups and triage counts

`GET /api/session-tree`

## Request

- Base URL: `http://localhost:3013`
- URL: `http://localhost:3013/api/session-tree`
- Auth: HTTP bearer

## Query parameters

- `show` 'mine' | 'all': Sessions v2 view, for a user viewer with tree scope. mine (default): roots the user started from a human channel (not workflow, schedule, or system) plus sessions shared with the user. all: every tree session. Lists only: access is unchanged.
- `hideSource` string: Comma-separated root sources to leave out, e.g. `slack,chat`. Older sessions v2 clients send this; `showSource` replaces it.
- `showSource` string: Comma-separated root sources to keep (the sessions v2 source filter), e.g. `ui,slack`. Present and empty keeps none; omit to keep every source.

## Response `200`

Visible groups and section counts

- object
  - `labels` object
  - `groups` object[], required
    - `total` integer, required
    - `unread` integer, required
    - `running` integer, required
    - `needsYou` integer, required
    - `key` string, required
    - `lastActivityAt` string, required
  - `inbox` object, required
    - `total` integer, required
    - `unread` integer, required
    - `running` integer, required
    - `needsYou` integer, required
  - `later` object, required
    - `total` integer, required
    - `unread` integer, required
    - `running` integer, required
    - `needsYou` integer, required
  - `done` object, required
    - `total` integer, required
    - `unread` integer, required
    - `running` integer, required
    - `needsYou` integer, required
  - `noGroup` object, required
    - `total` integer, required
    - `unread` integer, required
    - `running` integer, required
    - `needsYou` integer, required
  - `sources` object[], required: Each root source in this view with its session count, hidden sources included.
    - `source` string, required
    - `total` integer, required

## Other responses

- `401`: Unauthorized

## Changes

- **2026-10-25** `627f4846eca3`: 1 info
  - added the optional property `labels` to the response with the `200` status
- **2026-10-23** `3d98aed9b483`: 1 info
  - added the new optional `query` request parameter `showSource`
- **2026-10-23** `3d72e66c171a`: 2 info
  - added the new optional `query` request parameter `hideSource`
  - added the required property `sources` to the response with the `200` status
- **2026-10-23** `5b0f6abb32d5`: 1 info
  - added the new optional `query` request parameter `show`
- **2026-10-22** `a2e24c51a750`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/desplega-ai/apis/agent-swarm-api/changes/api/session-tree/get.md)

---

[API](https://skmtc.dev/desplega-ai/apis/agent-swarm-api.md) - [All operations](https://skmtc.dev/desplega-ai/apis/agent-swarm-api/llms.txt) - [OpenAPI document](https://skmtc.dev/desplega-ai/apis/agent-swarm-api/revisions/7e4c7198192a?raw)