From 4b093d7f176296fedfb486a49ba3b2347f85678e Mon Sep 17 00:00:00 2001
From: "sg-doc-holiday[bot]"
<219201796+sg-doc-holiday[bot]@users.noreply.github.com>
Date: Wed, 4 Feb 2026 16:09:10 +0000
Subject: [PATCH 1/4] getting-started: update user-management.mdx
Document password requirements in User Management, including the allowed special characters list updated in the password validation logic (now includes square brackets via `[]`). Also add shell language tags to existing API call examples to follow code block requirements.
---
getting-started/user-management.mdx | 10 ++++++++--
1 file changed, 8 insertions(+), 2 deletions(-)
diff --git a/getting-started/user-management.mdx b/getting-started/user-management.mdx
index b7c7685f..a0c92a14 100644
--- a/getting-started/user-management.mdx
+++ b/getting-started/user-management.mdx
@@ -10,13 +10,19 @@ When you deploy OpenOps for the first time, it creates an admin user account. Th
The admin user account created this way has exactly one distinction: it can be used to create other user accounts.
+## Password requirements
+
+User passwords must:
+* Be 8-64 characters long.
+* Include only alphanumeric characters and the following special characters: `!@#$%^&*()_+-=[]{};':"\|,.<>/?`
+
## Creating new user accounts
OpenOps doesn't currently provide a UI for creating user accounts; instead, you can do it with two API calls.
The first API call is to sign in the admin user:
-```
+```shell
POST http://your-openops-installation/api/v1/authentication/sign-in
Content-Type: application/json
@@ -28,7 +34,7 @@ Content-Type: application/json
This call will return a JSON object that contains a property called `token`. Copy the value of this property and use it in the authorization header in the next call. This next call actually creates a new user account. Before making the call, in the body, don't forget to specify actual values for the four properties that are left empty in the sample below:
-```
+```shell
POST http://your-openops-installation/api/v1/authentication/sign-up
Authorization: Bearer your-admin-token
Content-Type: application/json
From 06c658afbe4b4f27a1ac60dbf36b808fb82f6f2d Mon Sep 17 00:00:00 2001
From: "sg-doc-holiday[bot]"
<219201796+sg-doc-holiday[bot]@users.noreply.github.com>
Date: Wed, 4 Feb 2026 16:10:21 +0000
Subject: [PATCH 2/4] ai-assistance: update overview.mdx
Fix internal links to use absolute doc-root paths per style guide, ensuring links in the AI assistance overview render correctly in Mintlify navigation.
---
ai-assistance/overview.mdx | 4 ++--
1 file changed, 2 insertions(+), 2 deletions(-)
diff --git a/ai-assistance/overview.mdx b/ai-assistance/overview.mdx
index 014c576f..d8a566f2 100644
--- a/ai-assistance/overview.mdx
+++ b/ai-assistance/overview.mdx
@@ -52,14 +52,14 @@ When available, the AI assistant includes reasoning in its replies, showing whic
The **AI Step** action lets you run AI prompts in a separate step in your workflow, using outputs of its previous steps as context.
-You add **AI Step** as you would [add any other action](workflow-management/building-workflows#adding-more-actions). You then specify a prompt in the **Prompt** field and any relevant outputs of previous steps in the **Additional input** section:
+You add **AI Step** as you would [add any other action](/workflow-management/building-workflows#adding-more-actions). You then specify a prompt in the **Prompt** field and any relevant outputs of previous steps in the **Additional input** section:
Alternatively, you can combine prompt text and outputs from previous steps in the **Prompt** field.
### Generating commands and queries
-Whenever you work with an [action](/workflow-management/actions) that requires writing a CLI command or SQL query, you'll see the **Generate with AI** command next to the relevant property in the action's properties pane:
+Whenever you work with an [action](/workflow-management/actions/) that requires writing a CLI command or SQL query, you'll see the **Generate with AI** command next to the relevant property in the action's properties pane:
When you click **Generate with AI**, use the AI chat window to describe the outcome you want the command or query to achieve, and your LLM will generate it for you:
From a7d1b128cb9138aa8440917bd35ec1f23b2f0679 Mon Sep 17 00:00:00 2001
From: "sg-doc-holiday[bot]"
<219201796+sg-doc-holiday[bot]@users.noreply.github.com>
Date: Wed, 4 Feb 2026 16:14:21 +0000
Subject: [PATCH 3/4] ai-assistance: update overview.mdx
Update AI Assistance overview to include brief, user-facing guidance about selecting an AI model in the chat composer and noting provider icons, matching the newly implemented model selector behavior without going deeper than existing docs.
---
ai-assistance/overview.mdx | 9 +++++++++
1 file changed, 9 insertions(+)
diff --git a/ai-assistance/overview.mdx b/ai-assistance/overview.mdx
index d8a566f2..e4dddcff 100644
--- a/ai-assistance/overview.mdx
+++ b/ai-assistance/overview.mdx
@@ -48,6 +48,15 @@ It can also work with Amazon MCP servers, namely AWS Cost Explorer MCP Server, A
When available, the AI assistant includes reasoning in its replies, showing which tools (such as MCP servers) it used, displaying the raw data retrieved from those tools, and outlining next steps in plain language.
+### Selecting an AI model
+
+If multiple models are available for your selected provider, use the model selector in the chat composer to switch models.
+
+The model selector:
+* Shows the currently selected model.
+* Shows a loading indicator while the model list is being fetched.
+* Uses provider icons in the selector when available.
+
### AI Step action
The **AI Step** action lets you run AI prompts in a separate step in your workflow, using outputs of its previous steps as context.
From 961cb1dcb042c47b63e9e3a2d216dd69ffc44b15 Mon Sep 17 00:00:00 2001
From: "sg-doc-holiday[bot]"
<219201796+sg-doc-holiday[bot]@users.noreply.github.com>
Date: Wed, 4 Feb 2026 16:15:31 +0000
Subject: [PATCH 4/4] ai-assistance: update overview.mdx
Server-side chat handling now propagates tool-error events as structured tool outputs with an error flag. Add a minimal, user-facing note that errors can appear as tool output in the chat, without documenting internal SSE details.
---
ai-assistance/overview.mdx | 2 ++
1 file changed, 2 insertions(+)
diff --git a/ai-assistance/overview.mdx b/ai-assistance/overview.mdx
index e4dddcff..ad1f4221 100644
--- a/ai-assistance/overview.mdx
+++ b/ai-assistance/overview.mdx
@@ -48,6 +48,8 @@ It can also work with Amazon MCP servers, namely AWS Cost Explorer MCP Server, A
When available, the AI assistant includes reasoning in its replies, showing which tools (such as MCP servers) it used, displaying the raw data retrieved from those tools, and outlining next steps in plain language.
+If a tool call fails, the chat can display the tool output as an error.
+
### Selecting an AI model
If multiple models are available for your selected provider, use the model selector in the chat composer to switch models.