Settings

The Settings tab holds the one Chat setting you can change for your workspace: message retention.

Who can do this

Anyone with

Chat permission: administration.read

can see the value. Changing it needs administration.manage; without it the field is disabled and there is no Save button.

Where it is in the UI

Administration, then Settings. The tab has one field: Message retention (days, empty = forever).

• Leave it empty to keep messages forever. This is the starting value.
• Enter a whole number of days, 1 or more, to set a retention period.

Change the retention period

1. Open Administration and select Settings.

2. Enter the number of days, or clear the field.

3. Select Save. Chat confirms with “Settings saved.”

A value that is not a whole number of days is rejected with “Retention must be a whole number of days, or empty to keep messages forever.”

Caution

In this version Chat stores the retention value with your workspace but does not delete messages because of it. Do not rely on it to remove messages automatically.

What gets audited

Every save records SETTINGS_UPDATED in the audit log, with the value before and after. Chat re-checks your access at the Identity Server before it saves.

Related Identity Server task

None. Retention is a Chat setting, not an Identity Server one. To see who may change it, check which roles hold administration.manage in Roles and permissions.

For developers

The same action is available through the API: Read settings, Update settings. These operations need a user token; a machine client never gets administration permissions.