ai

share an AI session transcript by link

Changed on

Stores a read-only snapshot of the session that members of the workspace can open by id, or anyone with the link once it is public. Sharing the same session again updates that snapshot and keeps its id.

post/w/{workspace}/ai/shared_sessions/share

Request

  • Base URL: /api (relative, and the document was published on a file host, not at the API’s origin)
  • URL: /api/w/{workspace}/ai/shared_sessions/share
  • Auth: one of:
    • HTTP bearer
    • API key in cookie token

Path parameters

workspacestring required

Request body

session_idstring required

the session's id in the author's browser

namestring required
is_publicboolean

left as it is on an existing share when absent; a new share starts private

message_countinteger required
snapshotobject required

Response

the shared snapshot

idstring uuid required
namestring required
is_publicboolean required
message_countinteger required
created_bystring required
shared_atstring date-time required

Changes