v1

latestOpenAPI 3.0.3MIT2026-07-17323590.7 KB

Create share link

Creates a shareable link for a session snapshot. The share is scoped to the organization and can be accessed by any user in the same org. Rate limited to 50 shares per hour per user. The share contains a snapshot of the session at creation time (not live updates).

post/api/sessions/share

Headers

X-Grafana-Org-Idstring

Grafana organization ID for multi-tenant isolation. Defaults to '1' if not provided.

Request body

sessionIdstring required

Session ID to share

sessionDataobject required

Full session object (must include id and messages fields)

expiresInHoursinteger

Expiration time in hours (optional)

expiresInDaysinteger

Expiration time in days (optional, converted to hours)

Response

Share created

shareIdstring

Cryptographically secure share ID (base64 URL-safe 32-byte token)

shareUrlstring

Full URL to access the shared session

expiresAtstring date-time nullable

Expiration timestamp (null if no expiration)