Job requests
Learn how to configure job requests in your actions.
Job requests allow you to perform operations on your scheduled jobs. You can
- Add new scheduled jobs.
- Update an existing scheduled job.
- Delete a scheduled job.
Job requests only work with scheduled jobs, it is not possible to add, update or delete recurring jobs through requests.
Adding a new job request
Navigate to your action's Requests tab in Design mode and add a new request.
- Select Job as request type.
- Give a name to your request.
- Select the request method. Available options are Save a scheduled job, Delete a scheduled job.
To set values dynamically, such as from your inputs, you can reference to your action components within double curlies -- {{}}
.
Job request types
Save a scheduled job
Use this request to create or update a scheduled job in your app.
After adding the request, on Parameters tab, fill up the opening fields.
Scheduled time: It is a date time value in UTC millis format.
NoteThere are multiple apps available to convert human-readable date-time to UTC millis format, such as www.epochconverter.com.
Scheduled job ID: It is the identifier value of your job. Each job has a unique ID. If you do not enter any value, a new scheduled job is created with a randomly generated ID. If a job exist with the ID you provide in this field, then this request updates the existing scheduled job.
Scheduled job name: It is the name of your job. You can optionally enter a name.
Task: You can select from actions or workflows in your app.
- If you select a workflow, you are required to enter a payload to continue. You can provide the payload that will trigger the workflow you selected.
- If you select an action, the input parameters of your action open up. Enter values for the inputs to proceed.
To set scheduled time, job ID or name values or the input parameters of your tasks dynamically, such as by manipulating values of your inputs, you can reference to your action components within double curlies -- {{}}
.
Delete a scheduled job
Use this request to delete a scheduled job in your app.
After adding the request, on Parameters tab, fill up the Scheduled job ID with the unique identifier of the job you want to delete.
Scheduled job ID is the identifier value of your job. Each job has a unique ID. If you previously created your job through a job request, you can use the same ID you gave while saving your scheduled job.
Select Dynamic option to dynamically built the job's ID with your action's components, such as your inputs. You can reference to values in your components within double curlies -- {{}}
.