---
title: Create or Edit a Task
slug: user-guide-10x/create-or-edit-a-task
docTags: 
createdAt: 2025-06-18T11:01:36.089Z
---

A Swimlane task is an action or series of actions that consist of input, configuration details, output, and triggers. Tasks in Swimlane can be very complex and can contain multiple input and output variables.

Use Swimlane's task creation process to fine-tune the tasks that you want an application to run.

## Create a New Task

To create a new task:

1. From the Integrations, Tasks page, click the plus menu icon, and then select **Create a task**.
2. ::Image[]{src="https://api.archbee.com/api/optimize/511c8QBH-VHiwWnyzIwUb/SyFOHvlktbnoatKP8-b5B_create-new-task.png" size="34" width="364" height="308" position="center" showCaption="false"}
3. Alternatively, scroll down the page until you see your application and then click **Create Task**.
4. On Create a Task, Swimlane lists plugin actions. You can filter by vendor (on the right-side of the page), and/or type a task, plugin action, or vendor into the filter field. Once you find your desired task type, click **Create.**
5. If your task is eligible to be forked, you can also select **Fork** when creating your new task. A forked task is copied as an editable Python script.
6. ::Image[]{src="https://api.archbee.com/api/optimize/511c8QBH-VHiwWnyzIwUb/qYjxwqPHiQIhwobdmAdxS_create-or-fork.png" size="44" width="1168" height="409" position="center" showCaption="false"}
7. Next, Swimlane prompts you to name your task. You can also associate it with a related application or applet or leave it as a common task. Applications and applets can only utilize common tasks or tasks associated with them.
8. ::Image[]{src="https://api.archbee.com/api/optimize/511c8QBH-VHiwWnyzIwUb/R61VLuMuv9IzdliTr_IfA_name-task.png" size="48" width="688" height="396" position="center" showCaption="false"}
9. You must provide a unique name for your task in order to save it.
10. On the Integration, **General** tab, you can rename the task, provide a description, select or create an asset, set the appropriate ROI usage metrics, and enable or disable the task. You can also see the task parent and the task type for each task.

    ::Image[]{src="https://api.archbee.com/api/optimize/511c8QBH-VHiwWnyzIwUb/PymPQzaTey6otBMQ_74BT_taskgeneraltab.png" size="40" width="754" height="744" position="center" showCaption="false"}

    **Note:** By default, a task is enabled upon creation.
11. You can also set up Usage Metrics for this task. Usage Metrics track the time and cost you are saving by automating this task. To set Usage Metrics, under Integration ROI Calculation Metrics fill out the **Manual Time Expenditure** and **Personnel Costs** fields so that the value of the automation is calculated in Usage Metrics.
12. ::Image[]{src="https://api.archbee.com/api/optimize/511c8QBH-VHiwWnyzIwUb/o6Jcm_4I8Rjm_o0_YTVaG_task-usage-metrics.png" size="66" width="1518" height="220" position="center" showCaption="false"}
13. Now you are ready to begin configuring your task.

## Configure a Task

Click the Integration, **Configuration** tab to configure the task.

The details that you configure for your task vary depending upon the type of task that you create. Most tasks have a set of inputs that need to be configured in a form but others, for example Python or Powershell scripts, require a text editor.

:::hint{type="info"}
 Here, you can also reference the plugin details for the plugin that is associated with the task by clicking **View Plugin Details**.
:::

::Image[]{src="https://api.archbee.com/api/optimize/511c8QBH-VHiwWnyzIwUb/-NOG-bNdkcPpAqWNz1ffO_view-plugin-details.png" size="40" width="653" height="449" position="center" showCaption="false"}

In addition, you configure the outputs as well. Swimlane's automapping helps you step through the process of output mapping.

For detailed information about input and output configuration see:

- [Configure Task Input](docId\:a18JbA9DkQBGgTr8d4KJG)
- [Configure Task Output](docId\:OCwBK73t-1mQ2BIHOFC5P)

:::hint{type="info"}
 Swimlane tasks work best when they are short-lived jobs that can be quickly executed. Tasks will timeout and be terminated by the system after 4 hours. When a task times out another execution of the same task is queued to replace it.
:::

## Set Triggers

Click the Integrations, **Triggers** tab to specify the conditions that will cause this task to run.

Tasks can be triggered by the following conditions:

- **Scheduled** - Task runs by a specified time frame.
- **Email** - Task runs when a specified email is received.
- **Record Save** - Task runs whenever a specified record is saved in the associated application.
- **Integration** - Task runs when an integration runs.

You can also schedule a custom trigger with a valid cron expression.

::Image[]{src="https://api.archbee.com/api/optimize/511c8QBH-VHiwWnyzIwUb/jluIfItRb7Iisafcdms6i_triggertabauto.png" size="50" width="1713" height="856" position="center" showCaption="false"}

Tasks can be referenced from workflow or from an integration button in Swimlane's Application Builder. The Workflow tab shows any workflow actions that are associated with the current task. Click **Add/Edit Workflow** to associate a task with a new workflow action. The Manual tab displays any layout objects associated to the task in Application Builder. Click **Open Application Builder** to edit the application.

:::hint{type="info"}
Tasks that are triggered by an integration to update a specific value in a record are set to only affect the value once. This was designed so that integration record value changes do not run in a continual loop.
:::

### Set Scheduled Trigger

1. In your task, go to **Triggers** and select the trigger type **Scheduled**.
2. Select how often you would like the task triggered. You can specify minutely, hourly, daily, weekly, monthly, yearly, or custom.
3. ::Image[]{src="https://api.archbee.com/api/optimize/511c8QBH-VHiwWnyzIwUb/fYXIr2CIXkT4T_Ac9-Lud_scheduled-trigger.png" size="46" width="1201" height="404" position="center" showCaption="false"}
4. Click **Save**.

### Set Email Trigger

To set up an email trigger, you must have an email or IMAP asset, an application with text fields, and a configured task.

1. In your task, go to **Triggers** and set the trigger type to **Email**.
2. Select the asset you would like to use to trigger the task.
3. ::Image[]{src="https://api.archbee.com/api/optimize/511c8QBH-VHiwWnyzIwUb/2FccGoI3UJZkGyjBo--sy_email-trigger-asset.png" size="44" width="1252" height="357" position="center" showCaption="false"}
4. Under **Configuration**, click **Add Parameter**.
5. In the box that appears under **Script Inputs**. select the **Type** as Trigger, select the **Trigger Name** as Email, select the **Trigger Parameter** to the part of the email you want data pulled from, and enter the name of the parameter in **Variable**. Continue adding parameters for each section of data you want to be pulled from the emails.
6. ::Image[]{src="https://api.archbee.com/api/optimize/511c8QBH-VHiwWnyzIwUb/vUsXLBWP_Y1lmzn7uG4JS_add-parameter-for-email-body.png" size="42" width="1386" height="417" position="center" showCaption="false"}
7. Add any necessary manipulation in the python code.
8. ::Image[]{src="https://api.archbee.com/api/optimize/511c8QBH-VHiwWnyzIwUb/d2a11TkaxiOoff1OT0MqR_python-code-window.png" size="40" width="680" height="401" position="center" showCaption="false"}
9. Under **Outputs**, add the output type **Create/Update Records**.
10. Select the application and click **Map to Existing Fields**.
11. Map the parameters to a text field. These parameters should show up on the outputs page.
12. ::Image[]{src="https://api.archbee.com/api/optimize/511c8QBH-VHiwWnyzIwUb/s4sk6uBXsaQ5iEtKgmFzp_createrecord-parametermapping.png" size="50" width="1393" height="412" position="center" showCaption="false"}
13. Click **Save**.

### Set Record Save Trigger

To set up a record save trigger, you must have your task associated with an application.

1. In your task, go to **Triggers** and set the trigger type to **Record Save**. This will trigger the task every time a record is saved.
2. Click **Save**.
3. ::Image[]{src="https://api.archbee.com/api/optimize/511c8QBH-VHiwWnyzIwUb/aSijUIdyCC_OyfqqYrR30_record-save-trigger.png" size="46" width="949" height="247" position="center" showCaption="false"}
4. **Note:** If **Initial Save Only** is turned on, the task will only save during the first save of a new record.

### Set Integration Trigger

To use an integration trigger, you must have two tasks that you want to use.

1. In your first task, go to **Outputs** and click **Execute Another Task**.
2. Click the arrow next to **Execute Another Task** to expand the section. Select your second task. This second task will trigger once the first task is complete.
3. Click **Save**.
4. ::Image[]{src="https://api.archbee.com/api/optimize/511c8QBH-VHiwWnyzIwUb/IwnlkRD4js4v04N6loM8O_execute-another-task.png" size="52" width="1375" height="536" position="center" showCaption="false"}