Introduction
The Google Gemini integration lets you connect Rootly to your organization’s Google Gemini API account. Once connected, a new Gemini Chat Completion workflow action becomes available, allowing you to send prompts to Gemini models and capture their responses — directly within your incident and action item workflows. With the Google Gemini integration, you can:- Generate AI-powered incident summaries, analyses, and recommendations
- Send custom prompts to Gemini models with full Liquid template support
- Use a system prompt to define the model’s role, tone, or output constraints
- Choose from any Gemini model available on your API account
Before You Begin
Before setting up the Google Gemini integration, make sure you have:- A Rootly account with permission to manage integrations
- A Google AI Studio API key with access to Gemini models
Your API key is validated against the Gemini API when you save the integration. If validation fails, confirm the key is active and has access to at least one Gemini model.
Installation
Open the integrations page in Rootly
Navigate to the integrations page in your Rootly workspace and select Google Gemini.
Enter your API key
Paste your Google AI Studio API key into the API Key field. Rootly validates the key by fetching your available Gemini models before saving. Your key is encrypted at rest in Rootly.
Workflow Actions
Gemini Chat Completion
Sends a prompt to a Gemini model and captures the response as a workflow output. The model list is fetched dynamically from your API account.| Field | Description | Required |
|---|---|---|
| Model | The Gemini model to use — fetched from your account | Yes |
| Prompt | The user message — supports Liquid templating | Yes |
| System Prompt | Instructions for the model’s role or behavior — supports Liquid templating | No |
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.Troubleshooting
The API key is rejected on save
The API key is rejected on save
Rootly validates your API key by fetching the list of available Gemini models when you save. If validation fails, confirm the key is active in Google AI Studio and has not been revoked or restricted.
The workflow action fails with an authentication error
The workflow action fails with an authentication error
If the integration was working and then stopped, the API key may have been revoked or rotated. Update the key in the integration settings — Rootly re-validates on save.
The workflow action fails with a rate limit error
The workflow action fails with a rate limit error
Google Gemini enforces rate limits based on your API tier. Running many concurrent workflows may exceed requests-per-minute limits. Consider staggering workflows or upgrading your Google AI Studio plan for higher quota.
A model is not appearing in the model selector
A model is not appearing in the model selector
The model list is fetched dynamically from your API account and is filtered to Gemini models. If a model you expect is missing, confirm your API key has access to it — some models may require specific API tiers or allowlisting.
Liquid variables are not rendering correctly in the prompt
Liquid variables are not rendering correctly in the prompt
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.
Related Pages
Incident Workflows
Build workflows that use Gemini 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.