Manage automations

Browse automations and their runs

1. Log in to https://air.jetbrains.cloud with your JetBrains Account.

2. Open the Automations page.

3. In the main list, choose which automations to show:

   • Project for automations shared within a project

   • Personal for your personal automations

4. To make the list easier to browse, group automations by repository.

5. Select an automation in the list. This will open the page with automation details and the list of its runs.

6. To inspect a specific run, click it in the Runs section.

   The run output opens inline in the same panel. Depending on how the trigger handled the run's changes, you can open a pull request, inspect the run in JetBrains Air, or continue it in a new task – see Work with automation run results.

   

Filter and search the automation list

^{Use filters and search to quickly find the automations you need.}

1. On the Automations page, choose which automations to show:

   • Project for automations shared within a project

   • Personal for your personal automations

2. Use the All Projects filter to show automations for one project or for all projects. The Project column shows which project each automation belongs to.

3. Use the All Repositories filter to show automations for one repository or for all repositories.

4. To search by automation name, click the search icon and type your query.

Edit an automation

^{You can always edit your personal automations. To edit a project automation, you need to be an admin in that project and have access to its repository in the VCS provider.}

1. Open the Automations page and select the automation.

2. Start editing in one of the following ways:

   • click Edit in the automation header

   • open the automation menu and click Edit

3. Change the automation settings.

4. Click Save.

Run an automation manually

^{Use this to test an automation or start it on demand without waiting for a trigger.}

1. Open the Automations page and select the automation.

2. Start the run in one of the following ways:

   • select the automation and click Run Now on its details page

   • open the automation menu and click Run Now

   

3. In the Test Automation Manually dialog, set up the run:

   • Select the branch to check out.

   • Select how to handle the changes the run produces – see Change handling.

   • Optionally, enter Context for the run. The context stands in for the data a trigger would normally provide, such as an issue link, a pull request, or event details. Leave it empty to run the automation with no payload.

   

4. Click Run.

Stop a run in progress

^{Stop a run that is still in progress if you no longer need its result or started it by mistake.}

1. Open the Automations page and select the automation.

2. In the Runs section, find the run that is still in progress and click the stop icon next to it.

Pause and resume an automation

^{If you want an automation to stop reacting to its triggers for a while, pause it instead of deleting it. When you want it to run again, resume it.}

1. Open the Automations page and select the automation.

2. Open the automation menu and click Pause. The automation stays in the list in the Paused state but no longer starts when its triggers fire.

3. To resume, open the automation menu and click Resume. The automation reacts to its triggers again.

Assign an automation to a project

^{Assign an automation to a project so project admins can manage it and project members can use it. A project automation uses the project's AI credits instead of the credits of the person who created it. You can change the project at any time.}

1. Open the Automations page and select the automation.

2. Click Edit in the automation header.

3. Open the Project selector and choose a project. Choose Personal to make the automation personal again.

   

4. Click Save.

Duplicate an automation

^{Use this to create a new automation based on the existing one.}

1. Open the Automations page and select the automation.

2. Open the automation menu and click Duplicate.

3. Update the copied automation settings if needed.

4. Click Save.

Delete an automation

^{Use this to remove an automation you no longer need.}

1. Open the Automations page and select the automation.

2. Open the automation menu and click Delete.

3. Confirm deletion.