Skip to content

Jobs

Jobs let you automate tasks in AppStudio. A job is a sequence of actions that runs either on a schedule or when triggered manually. Use jobs to move data between systems, generate files, transform content, or run any repeatable workflow.

When to use this

  • You need to sync data between AppStudio and an external system on a regular basis
  • You want to generate reports or files automatically
  • You have a multi-step workflow that should run without manual intervention
  • You need to transform or convert data (JSON, XML, Excel, PDF)

How it works

A job consists of one or more actions that execute in order. Each action performs a specific operation — like making an HTTP request, transforming data, or generating a file. When a job runs, it creates a job run that tracks the status and results of each action.

Jobs can run:

  • Manually — you trigger the run from the job dashboard
  • On a schedule — the job runs automatically at a configured interval

The Jobs dashboard

Navigate to Jobs from your subscription's main navigation. The dashboard shows:

  • Latest — recently run or updated jobs
  • Favorites — jobs you've starred for quick access

Click All to see every job in your subscription.

Viewing all jobs

The jobs list shows each job with:

ColumnDescription
NameThe job's name
Latest runWhen the job last ran, and whether it succeeded or failed
Next scheduled runWhen the job is set to run next (if scheduled)
RunningWhether the job is currently executing

You can switch between a row view and a tile view, and search jobs by name.

TIP

Star frequently used jobs to add them to your Favorites on the dashboard.

Creating a job

  1. Navigate to Jobs.
  2. Click Create Job.
  3. Enter a name for the job.
  4. Click Save.

You're taken to the job's dashboard where you can start adding actions.

Job actions

Actions are the building blocks of a job. Each action performs one operation, and actions run in sequence.

Available action types

Action typeWhat it does
HTTP RequestSends an HTTP request to an external API or service
JSON TransformationTransforms JSON data using a mapping
JSON ConversionConverts data to or from JSON format
XML TransformationTransforms XML data using XSLT or similar
XML ConversionConverts data to or from XML format
MergingCombines multiple data sources into one
Artifact ManagementManages output files (artifacts) from the job
Job RunTriggers another job as part of this job's workflow
SleepPauses execution for a specified duration
Raise ErrorDeliberately fails the job (useful for conditional error handling)
Excel ConversionConverts data to or from Excel format
PDF ManagementGenerates or manipulates PDF files
QR Code GenerationCreates QR codes
AI AgentRuns an AI-powered action
JavascriptExecutes custom JavaScript code

Adding an action

  1. Open a job and go to the Actions section.
  2. Click Add Action.
  3. Choose the action type.
  4. Configure the action's settings.
  5. Click Save.

Actions run in the order they appear. You can reorder them by dragging.

Running a job

  1. Open the job you want to run.
  2. Click Run.
  3. If the job accepts variables, fill them in.
  4. Confirm to start the run.

The job executes its actions in sequence. You can monitor progress in real time.

Job runs

Every time a job runs, it creates a job run record. Navigate to a job's Runs section to see the full history.

Each job run shows:

FieldDescription
Start dateWhen the run started
End dateWhen the run completed
DurationHow long the run took
StatusSuccessful, Failed, Running, or Scheduled
ArtifactsAny files generated during the run (downloadable)

Click a job run to see the result of each individual action.

Subscribers

You can add subscribers to a job to notify people when it runs or fails. Navigate to the job's Subscribers section to manage who gets notified.

Job settings

Each job has a settings page where you can configure:

  • Name — the display name of the job
  • Schedule — set up automatic recurring runs
  • Variables — define input variables that can be provided when running the job

Tips

TIP

Use the Job Run action type to chain jobs together. This lets you build complex workflows from smaller, reusable jobs.

TIP

Download artifacts from completed job runs to access generated files like reports, exports, or converted documents.

Common mistakes

WARNING

If a job fails, check the individual action results in the job run detail. The failing action will show error details that help you diagnose the problem.

WARNING

Scheduled jobs will continue running even if previous runs have failed. Monitor your job runs regularly to catch recurring failures early.