Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.rootly.com/llms.txt

Use this file to discover all available pages before exploring further.

​
Introduction

The Mistral AI integration lets you connect Rootly to your organization’s Mistral AI API account. Once connected, a new Mistral Chat Completion workflow action becomes available, allowing you to send prompts to Mistral models and capture their responses — directly within your incident and action item workflows. With the Mistral AI integration, you can:
  • Generate AI-powered incident summaries, analyses, and recommendations
  • Send custom prompts to Mistral and Codestral models with full Liquid template support
  • Use a system prompt to define the model’s role, tone, or output constraints
  • Control response style with temperature, max tokens, and nucleus sampling parameters

​
Before You Begin

Before setting up the Mistral AI integration, make sure you have:
  • A Rootly account with permission to manage integrations
  • A Mistral AI API key with access to at least one model
Your API key is validated against the Mistral API when you save the integration. If validation fails, confirm the key is active and has not been revoked in the Mistral console.

​
Installation

Open the integrations page in Rootly

Navigate to the integrations page in your Rootly workspace and select Mistral AI.

Enter your API key

Paste your Mistral AI API key into the API Key field. Rootly validates the key by fetching your available models before saving. Your key is encrypted at rest in Rootly.

Integration connected

Your Mistral AI integration is active. The Mistral Chat Completion workflow action is now available in your incident and action item workflows.

​
Workflow Actions

​
Mistral Chat Completion

Sends a prompt to a Mistral model and captures the response as a workflow output. The model list is fetched dynamically from your API account and includes mistral-, codestral-, and open- model families.
FieldDescriptionRequired
ModelThe Mistral model to use — fetched from your accountYes
PromptThe user message — supports Liquid templatingYes
System PromptInstructions for the model’s role or behavior — supports Liquid templatingNo
TemperatureSampling temperature between 0.0 and 1.5 — controls randomnessNo
Max TokensMaximum number of tokens in the responseNo
Top PNucleus sampling probability between 0.0 and 1.0No
Use Liquid variables in your prompts to include live incident context — for example {{ incident.title }}, {{ incident.severity }}, and {{ incident.description }}. See the Liquid variables reference for all available fields.
The System Prompt field sets the model’s persona or output format — for example: “You are an incident response assistant. Respond in bullet points. Be concise.”

​
Troubleshooting

Rootly validates your API key by fetching the list of available models when you save. If validation fails, confirm the key is active in the Mistral console and has not been revoked or restricted.
If the integration was working and then stopped, the API key may have been rotated or revoked. Update the key in the integration settings — Rootly re-validates on save.
Mistral AI enforces rate limits based on your API tier. Running many concurrent workflows may exceed requests-per-minute limits. Consider staggering workflows, reducing token usage with more focused prompts, or upgrading your Mistral plan for higher quota.
The model list is fetched dynamically from your API account and is filtered to mistral-, codestral-, and open- model families. If a model you expect is missing, confirm your API key has access to it — some models may require specific Mistral tiers or allowlisting.
Check your Liquid syntax — unclosed tags or undefined variables can cause rendering failures. Use the Liquid variables reference to confirm variable names and test your template in a low-stakes workflow first.

Incident Workflows

Build workflows that use Mistral models to analyze, summarize, or respond to incidents.

Liquid Variables

Reference for all incident variables available in Liquid-templated prompts.

Rootly AI

Learn about Rootly’s built-in AI features for incident management.