Update the chat history settings for an organization (Beta)

View as Markdown
Update the chat history settings for an organization. Chat history stores user conversations with Sigma agents, Sigma Assistant, or warehouse agents so they persist across user sessions. **Beta**: This documentation describes a public beta feature and is subject to the [Beta features](/docs/sigma-product-releases#beta-features) disclaimer. - Chat history can only be enabled for organizations that meet certain conditions. For more details, see [Configure chat history](/docs/configure-chat-history). ### Usage notes - To perform this operation, you must use API credentials owned by a user assigned the Admin account type. - To read or update settings for a tenant organization, use [impersonation](/docs/impersonate-users) to obtain a token for that tenant, then call this endpoint with that token.

Authentication

AuthorizationBearer

OAuth authentication of the form <token>.

Request

The request body.
enabledbooleanRequired
Whether the setting is enabled for the organization.
retentionPeriodenumOptional

Number of days a chat conversation is kept before being deleted. Configurable independently of enabled.

Allowed values:

Response

The response body.
enabledboolean
Whether the setting is enabled for the organization.
retentionPeriodenum

Number of days a chat conversation is kept before being deleted. null if no retention period is configured.

Allowed values: