---
title: "The session's share link, or {\"token\": null} when sharing is off (owner only) [read]"
method: GET
path: "/sessions/{id}/share"
---

# The session's share link, or {"token": null} when sharing is off (owner only) \[read\]

`GET /sessions/{id}/share`

## Request

- Base URL: `https://api.agentsky.dev/v1`
- URL: `https://api.agentsky.dev/v1/sessions/{id}/share`
- Auth: HTTP bearer

## Path parameters

- `id` string, required

## Response `200`

OK

- SessionShareLink: token is null when sharing is off. A guest link carries shareUrl; a view-only link does not.
  - `token` string, nullable, required
  - `access` 'prompt' | 'view'
  - `shareUrl` string

## Other responses

- `default`: Error — { error: { code, message, request_id } }

## Changes

- **2026-11-02** `e5e8f0229a99`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/agentsky/apis/agentsky-developer-api/changes/sessions/:id/share/get.md)

---

[API](https://skmtc.dev/agentsky/apis/agentsky-developer-api.md) - [All operations](https://skmtc.dev/agentsky/apis/agentsky-developer-api/llms.txt) - [OpenAPI document](https://skmtc.dev/agentsky/apis/agentsky-developer-api/revisions/8280a065ef6a?raw)