KB489583: Passing System Prompts on Library Trusted Authentication

The following 2 trust headers were introduced:

mstr-system-prompts

A base64 JSON string consist of key-value pairs: the key is the system prompt index as a number string, and the value is the associated system prompt value. System prompt values should be utf8 encoded

See the following example:

The value above could be decoded as the following:

{
 "59": "Hello world",
 "60": "Line1\nLine2\nLine3",
 "74": 45,
 "89": "2025-10-10"
}

mstr-persist-system-prompts

A boolean string of either "true" or "false" indicates if the system prompt should be used on the server or locally in the current session. The default value is "true". The flag will have no effect is no system prompt is passed through login.

See the following example:

See the following list of system prompts that is available to trusted authentication:

When constructing mstr-system-prompts header, ensure to follow the below best practices:

• Ensure the JSON key/values are UTF-8 encoded before Base64 conversion.
• Keep the total header size under 8 KB to stay within server and proxy limits.
• Include only necessary prompts to reduce payload.
• Escape special characters properly in text prompts.
• Use ISO-8601 format (YYYY-MM-DD) for date prompts.