---
title: "Get Chat Share State"
method: GET
path: "/api/chat/sessions/{session_id}/share/state"
tags: ["v2", "chat", "share", "chat", "share"]
---

# Get Chat Share State

`GET /api/chat/sessions/{session_id}/share/state`

Return the chat's current share state.

The share modal calls this on open so it can render in the right
mode (share-vs-revoke) and pre-select the auto-share toggle.

## Path parameters

- `session_id` string, required

## Response `200`

Successful Response

- ChatShareStateResponse — Surfaces the chat's current share state so the modal can open in the right mode (share-vs-revoke) without an extra round-trip. The three counts power the consent-disclosure block above the toggle so the owner sees exactly what they're about to expose. They reflect live state — sharing is live (not snapshot-at-enable), so these numbers are also a lower bound for what subsequent viewers will see if more messages / runs / files land before revocation.
  - `is_shared` boolean
  - `share_token` string, nullable
  - `auto_share_executions` boolean
  - `message_count` integer
  - `linked_run_count` integer
  - `file_count` integer

## Other responses

- `401` — Authentication required
- `422` — Validation Error

---

[API](https://skmtc.net/significant-gravitas/apis/autogpt-agent-server.md) · [All operations](https://skmtc.net/significant-gravitas/apis/autogpt-agent-server/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/significant-gravitas/autogpt-agent-server/versions/382041c7ecb2/schema)