---
title: "Get shared session"
method: GET
path: "/api/sessions/shared/{shareId}"
tags: ["Shares"]
---

# Get shared session

`GET /api/sessions/shared/{shareId}`

Returns a read-only snapshot of a shared session. The share must belong to the same organization as the requesting user. The returned session includes `isShared: true` and `sharedBy` fields.

## Path parameters

- `shareId` string, required

## Headers

- `X-Grafana-Org-Id` string

## Response `200`

Shared session data

- object — Chat session with full message history
  - `id` string, required — Session ID (base64 URL-safe 32-byte token)
  - `title` string, required — Session title
  - `messages` SessionMessage[], required — All messages in the session
    - `role` 'user' | 'assistant', required — Message role
    - `content` string, required — Message text content
    - `toolCalls` object, nullable — Tool calls made (raw JSON)
    - `pageRefs` object, nullable — Page references (raw JSON)
  - `summary` string — Session summary
  - `createdAt` string, date-time, required
  - `updatedAt` string, date-time, required
  - `messageCount` integer, required — Total number of messages
  - `activeRunId` string — ID of currently active agent run (if any)
  - `model` 'base' | 'large' — LLM app model abstraction locked to this session, if selected
  - `isShared` true
  - `sharedBy` string — User ID who created the share

## Other responses

- `400` — Bad request (invalid parameters or malformed request body)
- `401` — Unauthorized (missing or invalid authentication)
- `403` — Access denied (not in same org as share)
- `404` — Share not found or expired
- `500` — Internal server error

---

[API](https://skmtc.net/consensys/apis/ask-o11y-ai-powered-observability-assistant-api.md) · [All operations](https://skmtc.net/consensys/apis/ask-o11y-ai-powered-observability-assistant-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/consensys/ask-o11y-ai-powered-observability-assistant-api/versions/3ccc03eccaef/schema)