AI

Change an AI conversation share

Changes the mode, expiry or tool redaction of one of the caller's shares, or moves a snapshot share to the conversation's latest history.

patch/api/{org_id}/ai/shares/{share_id}

Request

Path parameters

org_idstring required

Organization name

share_idstring required

Share ID

Request body

expires_in_secsinteger nullable

A number sets a new expiry from now; null removes the expiry.

modestring nullable
redact_toolsboolean nullable
refresh_snapshotboolean

Moves a snapshot share to the chat's latest committed history.

Response

The updated share

access_countinteger required
created_atinteger required
expires_atinteger nullable

Microseconds since the epoch; absent when the share never expires.

idstring required
last_accessed_atinteger nullable
modestring required
owner_emailstring nullable

The creator's email; only in the org-wide admin listing.

owner_namestring nullable

The creator's display name (email when unnamed); only in the org-wide admin listing.

redact_toolsboolean required

Readers see assistant text and tool names, never tool inputs or outputs.

session_idstring required
snapshot_seqinteger nullable
titlestring required
tokenstring nullable

Bearer secret of the link; absent on other creators' rows of the org-wide listing.

updated_atinteger required
url_pathstring nullable

Path of the web page that shows the share; absent whenever token is.

visibilitystring required

Changes

No recorded changes to this operation across all 1 revision of this API.