---
title: "Triage every session of one sidebar list"
method: POST
path: "/api/session-triage"
tags: ["Sessions"]
---

# Triage every session of one sidebar list

`POST /api/session-triage`

## Request

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

The bulk bar's 'Select all N': Done, back to the Inbox, read, or unread for every session that one sessions v2 list shows the caller (the `GET /api/sessions?scope=tree` filters). Needs a picked user.

## Request body

- object
  - `action` 'done' | 'inbox' | 'read' | 'unread', required
  - `triage` 'inbox' | 'later' | 'done'
  - `noGroup` boolean
  - `groupKey` string
  - `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[]
  - `showSource` string[]

## Response `200`

The number of sessions written

- object
  - `updated` integer, required

## Other responses

- `400`: Validation error, or no picked user
- `401`: Unauthorized

## Changes

- **2026-10-23** `3d98aed9b483`: 1 info
  - added the new optional request property `showSource`
- **2026-10-23** `3d72e66c171a`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/desplega-ai/apis/agent-swarm-api/changes/api/session-triage/post.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)