Update the chat history settings for an organization (Beta)
Update the chat history settings for an organization (Beta)
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.
enabled
Whether the setting is enabled for the organization.
retentionPeriod
Number of days a chat conversation is kept before being deleted. Configurable independently of enabled.
Allowed values:
Response
The response body.
enabled
Whether the setting is enabled for the organization.
retentionPeriod
Number of days a chat conversation is kept before being deleted. null if no retention period is configured.
Allowed values:

