---
title: "List a session's active shares"
method: GET
path: "/api/sessions/{rootTaskId}/shares"
tags: ["Sessions"]
---

# List a session's active shares

`GET /api/sessions/{rootTaskId}/shares`

## Request

- Base URL: `http://localhost:3013`
- URL: `http://localhost:3013/api/sessions/{rootTaskId}/shares`
- Auth: HTTP bearer

Active shares only. `everyone` is the access every user has; `users` are per-person shares. A session with no shares is private to its owner.

## Path parameters

- `rootTaskId` string, required

## Response `200`

Active shares

- SessionShares
  - `everyone` 'none' | 'read' | 'write', required
  - `users` object[], required
    - `userId` string, required
    - `access` 'read' | 'write', required
    - `createdAt` string, required

## Other responses

- `401`: Unauthorized
- `403`: The caller has no access to this session
- `404`: Root task not found

## Changes

- **2026-10-19** `47fc2bbb7544`: 1 info
  - endpoint added

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