# Using the Sync Jobs UI

> Source: https://truto.one/docs/guides/sync-jobs/using-the-ui/

Manage sync jobs from [app.truto.one](https://app.truto.one). Sign in, then choose **Sync Jobs** in the sidebar.

This guide walks through each screen in the dashboard. For what sync jobs, runs, schedules, and templates mean, see the [Sync Jobs overview](/docs/guides/sync-jobs/overview).

## List jobs

The **Jobs** tab lists every sync job in the selected environment.

![Sync Jobs list](/images/sync-jobs/list.png)

1. **Sync Jobs** in the sidebar opens this page.
2. **Jobs** and **Templates** switch between your job list and reusable blueprints.
3. **Create job** opens the form for a new sync job.
4. Search filters jobs by label, integration, or ID.
5. The environment selector limits the list to one environment.
6. Each row shows **Label**, **Integration**, **Version**, and **Updated**. Click the label to open the job.
7. The row menu offers **Edit**, **Trigger run**, and **Delete**.

## Open a job

Click a job's label to open its detail page.

![Sync Job detail Overview](/images/sync-jobs/detail-overview.png)

1. **« Sync jobs** returns to the list.
2. The job **Label** and runtime version tag appear at the top.
3. **Trigger run** starts a new sync job run.
4. The row menu offers **Edit** and **Delete**.
5. The job ID and integration name are shown below the title.
6. **Overview**, **Runs**, **Schedules**, and **Settings** switch between detail tabs.

## Overview

The **Overview** tab is a read-only summary of the job definition.

![Sync Job detail Overview](/images/sync-jobs/detail-overview.png)

1. **Label**, **Integration**, **Runtime version**, and **Delay between requests (ms)** describe the job at a glance.
2. **Mutex key** and **State key** control concurrency and incremental sync state.
3. **Created** and **Updated** show when the job last changed.
4. **Resources** shows the pipeline definition (read-only JSON).
5. **Arguments schema** and **Arguments validation** appear when the job accepts runtime arguments.

## Runs

The **Runs** tab lists every sync job run for this job.

![Sync Job detail Runs](/images/sync-jobs/detail-runs.png)

1. Filter by run ID, **Status**, or date range.
2. Each row shows **Run ID**, **Status**, **Started**, **Duration**, and **Records**.
3. Click a run ID to open the run detail page.
4. The row menu on active runs includes **Stop run**.
5. **Load more** fetches additional runs when the list is paginated.

To start a run from the job header, click **Trigger run**. The modal title is **Trigger run ·** followed by the job label. Fill in the integrated account, destination, and any arguments required by the job, then confirm with **Trigger run**.

## Schedules

The **Schedules** tab lists cron triggers that run this job automatically.

![Sync Job detail Schedules](/images/sync-jobs/detail-schedules.png)

1. The header notes that schedules use a UTC cron expression.
2. **Add schedule** opens the schedule form.
3. Each row shows **Cron expression** (with a UTC label), **Target** (integrated account and destination), and **Updated**.
4. The row menu offers **Edit** and **Delete**.
5. When no schedules exist, **Add schedule** is also shown in the empty state.

Schedules run in UTC with a minimum five-minute interval.

## Settings

The **Settings** tab is where you edit or delete a job.

![Sync Job detail Settings](/images/sync-jobs/detail-settings.png)

1. **Label** — a name to identify this sync job.
2. **Runtime version** — the runtime that powers this job. Version 4 is recommended for new jobs.
3. **Integration name** — the integration this job is associated with, if any.
4. **Resources** — the pipeline definition as JSON.
5. **Arguments schema** and **Arguments validation** — optional runtime arguments and validation rules.
6. **Mutex key** and **State key** — optional keys for concurrency and persistent state.
7. **Delay between requests (ms)** — optional throttle between API calls.
8. **Save changes** applies your edits.
9. **Delete sync job** permanently removes the job and its run history.

## Run detail

Click a run ID on the **Runs** tab to inspect a single sync job run.

![Sync Job run detail](/images/sync-jobs/run-detail.png)

1. **« Runs** returns to the run list for this job.
2. The run **Status** tag reflects the current state (for example **Running**, **Completed**, or **Failed**).
3. **View logs** opens the log viewer for this run.
4. **Stop run** appears while the run is still active.
5. **Sync job** links back to the parent job.
6. **Runtime version**, **Error handling**, and destination fields (such as **Integrated account**, **Webhook**, or **Datastore**) show how this run was configured.
7. **Started**, **Finished**, **Duration**, and **Created** summarize timing.
8. **Records processed** breaks down persisted record counts per resource.
9. **Arguments** shows the JSON args passed when the run was triggered.

## Templates

Switch to the **Templates** tab to browse reusable sync job blueprints.

![Sync Job Templates](/images/sync-jobs/templates.png)

1. **Create template** opens the template form.
2. Search filters templates by label, integration, description, or ID.
3. Each row shows **Label**, **Integration**, **Version**, **Description**, and **Sharing** (**Shared** or **Private**).
4. The row menu offers **Create job from template** for every template. **Edit** and **Delete** appear on templates you own.
5. **Create job from template** opens the job form pre-filled from the template so you can save it as a new sync job in your environment.