Skip to main content

GET /api/v1/settings/interaction-store

Returns the current interaction store backend setting for the tenant.

Response

Roles

admin only

PUT /api/v1/settings/interaction-store

Update the interaction store backend. This changes the storage engine used for new interaction history writes.

Request Body

FieldTypeRequiredDescription
backendstringYesOne of: postgresql, keyspaces, scylla, dynamodb

Backend Options

BackendDescription
postgresqlDefault. Standard PostgreSQL storage with partition support.
keyspacesAmazon Keyspaces (managed Cassandra). High-throughput write-heavy workloads.
scyllaScyllaDB. Low-latency, high-throughput Cassandra-compatible storage.
dynamodbAmazon DynamoDB. Serverless, auto-scaling NoSQL storage.

Example

Response

Error Codes

CodeReason
400Invalid backend value
Changing the backend does not migrate existing data. Historical interactions remain in the previous backend. Plan a data migration separately when switching backends in production.

Roles

admin only See also: Settings | Platform Settings