Update the AI configuration

POST

/api/v1/ai/configuration

Update how the AI behaves for a workspace: its main language, product name, custom rules, response length, PII filtering and feedback replies.

Notes

• A partial configuration is accepted. Fields you leave out keep their stored value, and derived attributes are recomputed from the merged result
• accountId and websiteId come from the auth headers; anything the body says about them is ignored
• Toggling optimizerEnabled clears the training-data content hashes, which makes the next ingest re-process every source
• A translationCorpus whose rows have no recognised language column is rejected with 400. That normally means the CSV headers are not language names

Parameters

Header Parameters

x-api-key

required

string

Your API key from account settings.

x-user-email

required

string

The email address of your user.

x-account-id

required

string

The ID of your account. You can find this in the account settings.

x-website-id

required

string

The ID of the workspace you want to use.

Request Body ^required

object

mainLanguage

Primary language the AI answers in, as an ISO code.

string

productName

Name the AI uses for the product it supports.

string

customRules

Extra instructions applied to every answer.

string

nullable

responseLength

How long answers should be, e.g. Max.

string

suggestReplies

boolean

componentFilterPII

boolean

filterPIIByDefault

boolean

allowedPIIWords

Words never treated as PII, however the detector scores them.

Array<string>

allowAllLanguages

boolean

restrictedAllowedLanguages

The languages the AI may answer in when allowAllLanguages is false.

Array<string>

negativeFeedbackReply

string

positiveFeedbackReply

string

optimizerEnabled

Changing this clears the training-data hashes and forces a full re-ingest.

boolean

topK

How many documents are retrieved per question.

number

modelTemperatureForAnswers

number

translationCorpus

Glossary of terms that must translate a fixed way. Rows are keyed by language name.

object

Example

{
  "productName": "Unless",
  "customRules": "Always answer in a friendly tone.",
  "responseLength": "Max",
  "suggestReplies": true
}

Responses

200

The stored configuration.

400

Bad request - missing body or websiteId, or an invalid translation corpus.

401

Unauthorized - invalid API key.