Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 2 additions & 2 deletions admin-openapi.json
Original file line number Diff line number Diff line change
Expand Up @@ -580,7 +580,7 @@
"schema": {
"type": "string"
},
"description": "The ID of the automation to trigger. Copy it from the automation's settings panel on the [Automations](https://app.mintlify.com/settings/project/automations) page in your dashboard."
"description": "The ID of the automation to trigger. Copy it from the automation's settings panel in your [Automations](https://app.mintlify.com/settings/project/automations) settings."
}
],
"responses": {
Expand All @@ -596,7 +596,7 @@
},
"runId": {
"type": "string",
"description": "The ID of the queued automation run. Appears in the run history on the [Automations](https://app.mintlify.com/settings/project/automations) page."
"description": "The ID of the queued automation run. Appears on the **Runs** tab of your [Automations](https://app.mintlify.com/settings/project/automations?tab=runs) settings."
}
}
}
Expand Down
2 changes: 1 addition & 1 deletion agent/index.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -42,7 +42,7 @@ By default, the agent opens pull requests attributed to the Mintlify bot. To att

By default, the agent opens a pull request for every change so your team can review it before it ships. If Mintlify hosts your project, the agent commits changes directly to your deployment branch so changes publish immediately.

For projects connected to your own Git provider, click **Configure Slack** on the [Automations](https://app.mintlify.com/settings/project/automations) page of your dashboard, then set **Review process** in Slack settings:
For projects connected to your own Git provider, click **Configure Slack** in your [Automations](https://app.mintlify.com/settings/project/automations) settings, then set **Review process** in Slack settings:

- **Create a pull request**: The agent commits to a new branch and opens a pull request against your deploy branch. Use this option when you want a human to review changes before they publish.
- **Push to main**: The agent commits directly to your deploy branch, and changes publish as soon as the agent finishes. Use this option when you trust the agent to publish without review, for example on a staging deployment.
Expand Down
8 changes: 4 additions & 4 deletions agent/slack.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -22,7 +22,7 @@
You can install the Slack agent even if you don't have a Mintlify-hosted project. The agent still works for question answering and conversations. Features that open pull requests require a connected repository.
</Note>

1. Navigate to the [Automations](https://app.mintlify.com/settings/project/automations) page in your dashboard.
1. Open your [Automations](https://app.mintlify.com/settings/project/automations) settings.
2. Click **Connect Slack**.
3. Follow the Slack prompts to install the `mintlify` app in your workspace and grant the requested permissions.
4. Confirm the connection in your Mintlify dashboard to your Slack workspace.
Expand All @@ -46,7 +46,7 @@

To remove the agent from your Slack workspace:

1. Navigate to the [Automations](https://app.mintlify.com/settings/project/automations) page in your dashboard.
1. Open your [Automations](https://app.mintlify.com/settings/project/automations) settings.
2. Click **Configure Slack**.
3. Click **Disconnect** to revoke the connection between Mintlify and your workspace.
4. In Slack, navigate to **Manage apps**.
Expand Down Expand Up @@ -135,7 +135,7 @@

## Manage automations

The Slack agent and [Automations](/automations) both use the Mintlify agent. Ask the agent to create, configure, run, or troubleshoot any automation. It can perform every action available to you on the [Automations](https://app.mintlify.com/settings/project/automations) page of your dashboard.
The Slack agent and [Automations](/automations) both use the Mintlify agent. Ask the agent to create, configure, run, or troubleshoot any automation. It can perform every action available to you in your [Automations](https://app.mintlify.com/settings/project/automations) settings.

Example prompts:

Expand All @@ -147,12 +147,12 @@

You can also ask the agent about automation activity, such as recent runs, failures, or credit use.

- "How can I make my automations more credit efficient?"

Check warning on line 150 in agent/slack.mdx

View check run for this annotation

Mintlify / Mintlify Validation (mintlify) - vale-spellcheck

agent/slack.mdx#L150

Avoid first-person pronouns such as ' I '.

Check warning on line 150 in agent/slack.mdx

View check run for this annotation

Mintlify / Mintlify Validation (mintlify) - vale-spellcheck

agent/slack.mdx#L150

Avoid first-person pronouns such as 'my'.
- "Why did the last run of the code change automation fail?"

### Trigger automations from Slack messages

You can configure a custom automation to run when someone posts a top-level message in a chosen Slack channel. The agent reads each message, decides whether it warrants a documentation update, and opens a pull request when it does. Set this up when you create or edit the automation on the [Automations](https://app.mintlify.com/settings/project/automations) page.
You can configure a custom automation to run when someone posts a top-level message in a chosen Slack channel. The agent reads each message, decides whether it warrants a documentation update, and opens a pull request when it does. Set this up when you create or edit the automation in your [Automations](https://app.mintlify.com/settings/project/automations) settings.

The `mintlify` app must be a member of the channel you choose. Invite it with `/invite @mintlify` before saving the automation.

Expand Down
2 changes: 1 addition & 1 deletion api/automations/webhook.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -16,7 +16,7 @@ This endpoint only supports [custom automations](/automations/create) with a web

## Get the webhook URL and auth header

Open the [Automations](https://app.mintlify.com/settings/project/automations) page in your dashboard and click the <Icon icon="settings-2" /> settings button on a custom automation with a webhook trigger. The trigger card shows the full webhook URL and a **Copy auth header** action for the `Authorization: Bearer <api-key>` header template.
Open your [Automations](https://app.mintlify.com/settings/project/automations) settings and click the <Icon icon="settings-2" /> settings button on a custom automation with a webhook trigger. The trigger card shows the full webhook URL and a **Copy auth header** action for the `Authorization: Bearer <api-key>` header template.

Replace `<api-key>` with an unexpired organization API key with write access. Create or manage keys on the [API keys](https://app.mintlify.com/settings/organization/api-keys) page. Automations do not create, store, or rotate keys on your behalf.

Expand Down
6 changes: 3 additions & 3 deletions automations/create.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -23,7 +23,7 @@ For an overview of triggers, update modes, and configuration options shared acro
The agent runs in an isolated sandbox with restricted internet access. It cannot install additional packages or tools at runtime. Prompts that reference unavailable tools may produce unexpected results or fail.
</Note>

1. Open the [Automations](https://app.mintlify.com/settings/project/automations) page in your dashboard.
1. Open your [Automations](https://app.mintlify.com/settings/project/automations) settings.
2. Click **New automation**.
3. On the configure page, set the automation name, trigger, prompt, context repositories, integrations, and update mode. For details on each field, see [Configurations](/automations/manage#configurations).
4. Click **Save**.
Expand Down Expand Up @@ -64,7 +64,7 @@ Review the run in the [run history](/automations/manage#view-run-history) to see

## Edit a custom automation

1. Open the [Automations](https://app.mintlify.com/settings/project/automations) page in your dashboard.
1. Open your [Automations](https://app.mintlify.com/settings/project/automations) settings.
2. Click the <Icon icon="settings-2" /> settings button on the automation's card to open its configure page.
3. Update any of the fields described in [Configurations](/automations/manage#configurations).
4. Click **Save**.
Expand All @@ -73,6 +73,6 @@ Review the run in the [run history](/automations/manage#view-run-history) to see

Deleting an automation is permanent and removes its configuration and run history.

1. Open the [Automations](https://app.mintlify.com/settings/project/automations) page in your dashboard.
1. Open your [Automations](https://app.mintlify.com/settings/project/automations) settings.
2. Click the <Icon icon="settings-2" /> settings button on the automation's card to open its configure page.
3. Click **Delete automation** at the bottom of the page and confirm.
14 changes: 7 additions & 7 deletions automations/manage.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -14,7 +14,7 @@ import GitlabAutomationSetup from '/snippets/gitlab-automation-setup.mdx';

## Enable an automation

1. Open the [Automations](https://app.mintlify.com/settings/project/automations) page in your dashboard.
1. Open your [Automations](https://app.mintlify.com/settings/project/automations) settings.
2. Click the toggle beside an automation to enable it.

If the automation can run with default settings, it activates immediately. Otherwise, the automation's configure page opens so you can fill in any required configurations.
Expand Down Expand Up @@ -77,7 +77,7 @@ Send Slack messages to one or more channels when automations run.

To enable Slack notifications:
1. Install the [Mintlify Slack app](/agent/slack) in your workspace.
2. Click **Configure Slack** on the [Automations](https://app.mintlify.com/settings/project/automations) page of your dashboard.
2. Click **Configure Slack** in your [Automations](https://app.mintlify.com/settings/project/automations) settings.
3. Select one or more channels to send notifications to.
4. Click **Save changes**.

Expand Down Expand Up @@ -110,7 +110,7 @@ You can add target languages at any time by opening the automation's configure p

## Disable an automation

1. Open the [Automations](https://app.mintlify.com/settings/project/automations) page in your dashboard.
1. Open your [Automations](https://app.mintlify.com/settings/project/automations) settings.
2. Click the toggle beside an automation to disable it.

When you re-enable a scheduled automation or change its schedule, Mintlify recalculates the next run time from the current time. Disabled automations do not retain a pending run time.
Expand All @@ -119,15 +119,15 @@ When you re-enable a scheduled automation or change its schedule, Mintlify recal

Deletion is permanent and cannot be undone.

1. Open the [Automations](https://app.mintlify.com/settings/project/automations) page in your dashboard.
1. Open your [Automations](https://app.mintlify.com/settings/project/automations) settings.
2. Click the <Icon icon="settings-2" /> settings button on the custom automation's card to open its configure page.
3. Click **Delete automation** at the bottom of the page and confirm.

## Run an automation manually

You can trigger an automation on demand without waiting for its next scheduled or event-based run.

1. Open the [Automations](https://app.mintlify.com/settings/project/automations) page in your dashboard.
1. Open your [Automations](https://app.mintlify.com/settings/project/automations) settings.
2. Click the <Icon icon="settings-2" /> settings button on the automation's card to open its configure page.
3. Click the run button (**Test run** or **Run now**, depending on the automation).
4. Select the run scope.
Expand All @@ -154,11 +154,11 @@ Runs triggered through the webhook use the automation's saved prompt, read the f

## View run history

The [Runs](https://app.mintlify.com/settings/project/automations?tab=runs) tab on the automations page displays a list of all runs for all automations.
The [Runs](https://app.mintlify.com/settings/project/automations?tab=runs) tab in your Automations settings displays a list of all runs for all automations.

A run is one execution of an automation. A run can create a new pull request, update an existing pull request, fail to run, or find nothing to change.

1. Open the [Automations](https://app.mintlify.com/settings/project/automations?tab=runs) page in your dashboard.
1. Open the **Runs** tab in your [Automations](https://app.mintlify.com/settings/project/automations?tab=runs) settings.
2. Use the dropdown menus to filter by specific automations or status.

Each result shows one of the following statuses:
Expand Down
2 changes: 1 addition & 1 deletion automations/reference.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@ description: "Reference for all predefined Mintlify automations, including defau
keywords: ["predefined", "automation", "default"]
---

Mintlify includes predefined automations for the most common documentation maintenance tasks. Each automation has a base prompt and a default configuration. You can customize the trigger, update mode, and instructions from the [Automations](https://app.mintlify.com/settings/project/automations) page in your dashboard.
Mintlify includes predefined automations for the most common documentation maintenance tasks. Each automation has a base prompt and a default configuration. You can customize the trigger, update mode, and instructions in your [Automations](https://app.mintlify.com/settings/project/automations) settings.

## At a glance

Expand Down
4 changes: 2 additions & 2 deletions guides/use-automations.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -29,7 +29,7 @@ Each automation runs on one of four trigger types. Choose the one that matches w

## Predefined automations

Mintlify includes predefined automations for the most common content maintenance tasks. Enable any of them from the [Automations](https://app.mintlify.com/settings/project/automations) page of your dashboard.
Mintlify includes predefined automations for the most common content maintenance tasks. Enable any of them in your [Automations](https://app.mintlify.com/settings/project/automations) settings.

See [Predefined automations](/automations/reference) for more details.

Expand Down Expand Up @@ -102,7 +102,7 @@ Scheduling cron jobs to run at specific times gives you more precise control ove

Automations run automatically, but they benefit from periodic review.

1. Open the **Runs** tab on the [Automations](https://app.mintlify.com/settings/project/automations) page to see recent run history and status.
1. Open the **Runs** tab in your [Automations](https://app.mintlify.com/settings/project/automations?tab=runs) settings to see recent run history and status.
2. To see more information about a run, click the <Icon icon="ellipsis" /> actions menu button and select **View run details** to see the prompt, summary, files, and pull request.
3. If results are inconsistent, refine your instructions: add more specific procedures, narrow the file scope, or split the automation into smaller tasks.

Expand Down
4 changes: 2 additions & 2 deletions openapi.json
Original file line number Diff line number Diff line change
Expand Up @@ -396,7 +396,7 @@
{
"name": "workflowSchemaId",
"in": "path",
"description": "The ID of the automation to trigger. Can be copied from the automation's settings panel on the [Automations](https://app.mintlify.com/settings/project/automations) page in your dashboard.",
"description": "The ID of the automation to trigger. Can be copied from the automation's settings panel in your [Automations](https://app.mintlify.com/settings/project/automations) settings.",
"required": true,
"schema": {
"type": "string"
Expand All @@ -417,7 +417,7 @@
},
"instanceId": {
"type": "string",
"description": "The ID of the queued automation run. Appears in the run history on the [Automation Runs](https://app.mintlify.com/settings/project/automations) page."
"description": "The ID of the queued automation run. Appears on the **Runs** tab of your [Automations](https://app.mintlify.com/settings/project/automations?tab=runs) settings."
},
"jobId": {
"type": "string",
Expand Down
Loading