---
title: "Mark a session publicly viewable"
method: POST
path: "/api/v1/cache/{org}/{repo}/session/{sessionId}/share"
tags: ["Session Shares"]
---

# Mark a session publicly viewable

`POST /api/v1/cache/{org}/{repo}/session/{sessionId}/share`

Marks the session publicly viewable without auth (entire-api mints a dedicated share token). Idempotent. Requires repo access and `public_sharing_enabled` on the repo. Public GitHub repos don't need (or accept) this — sessions there are always public. 409 if the repo is public or if `public_sharing_enabled` is off.

## Path parameters

- `org` string, required
- `repo` string, required
- `sessionId` string, required

## Query parameters

- `provider` 'gh' | 'et'

## Response `200`

Share enabled

- object
  - `isPublic` boolean, required
  - `shareId` string
  - `cell` string

## Other responses

- `400` — Invalid session ID
- `404` — Repo not found or no access
- `409` — Repo-level public sharing is disabled, or repo is public

---

[API](https://skmtc.dev/entire/apis/entire-api.md) · [All operations](https://skmtc.dev/entire/apis/entire-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/entire/entire-api/revisions/c3d737ae064e/schema)