> For the complete documentation index, see [llms.txt](https://docs.telm.ai/telmai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.telm.ai/telmai/connect-to-data/triggering-scans.md).

# Triggering Scans

Run scans on demand, schedule them, and follow their progress.

A scan reads an asset's data, profiles it and runs its monitors. You can start scans by hand, schedule them, or trigger them through the API.

## Scan an asset now <a href="#trigger-job-using-telmai-ui" id="trigger-job-using-telmai-ui"></a>

1. Open the asset from **Assets**.
2. Click **Scan now** at the top right of the asset.

While the scan runs, the button turns into **Cancel scan**, and the header shows the scan's status.

For assets that have a timestamp attribute, the arrow next to **Scan now** offers two more options:

| Option          | What it scans                                                                                                                          |
| --------------- | -------------------------------------------------------------------------------------------------------------------------------------- |
| Historical scan | The last 10 intervals of data, based on the timestamp attribute and the schedule frequency. Use it to build a history for a new asset. |
| Single scan     | The latest interval of data, based on the timestamp attribute and the schedule frequency.                                              |

These options aren't available when the asset is set to scan metadata only.

You can also start scans from other places:

* **Scan now** in the asset tree's [Manage mode](https://docs.telm.ai/telmai/connect-to-data/managing-assets.md#manage-assets-in-bulk), for up to 10 assets at once, or **Scan assets** for a group.
* **Scan now** on each row of [Reports > Stale assets](https://docs.telm.ai/telmai/monitoring-data/reports.md#stale-assets).

{% hint style="info" %}
Users with the Viewer role can't start or cancel scans.
{% endhint %}

## Schedule scans <a href="#scheduling-scans" id="scheduling-scans"></a>

To scan an asset on a schedule:

1. Open the asset and go to its **Settings** tab. You can also click **Set schedule** in the **Details** card of the **Overview** tab.
2. Under **Scanning** > **Schedule**, click **Set schedule** and choose how often to scan.
3. Click **Save**.

To schedule several assets at once, select them in the asset tree's [Manage mode](https://docs.telm.ai/telmai/connect-to-data/managing-assets.md#manage-assets-in-bulk) and click **Schedule**. Assets in a group share the group's schedule: use **Schedule** in the group's **⋯** menu.

## Scan history

The asset's **Scans** tab lists its scans, newest first.

<figure><img src="https://604868671-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkO3-a8YVu1iq1jP__S%2Fuploads%2Fgit-blob-6407f98e97b53fc3da2eb303766ab258e2fc8bb5%2Fasset-scans-2026-11-04.png?alt=media" alt="The Scans tab with job IDs, start times, execution times, statuses and details"><figcaption><p>The Scans tab of an asset.</p></figcaption></figure>

| Column         | Description                                                                                                |
| -------------- | ---------------------------------------------------------------------------------------------------------- |
| Job ID         | The scan job's ID. Click the copy icon to copy it, for example to share with Telmai support.               |
| Start time     | When the scan started.                                                                                     |
| Execution time | How long the scan ran.                                                                                     |
| Status         | **Queued**, **Preparing**, **Running**, **Waiting for batch**, **Completed**, **Failed** or **Cancelled**. |
| Details        | **Finished successfully**, or the reason a scan failed. Click the copy icon to copy an error.              |

Use **Search by job ID or details** to find a scan. With no recent scans, the tab says **No scans in the last 30 days**.

## Trigger scans through the API <a href="#trigger-job-using-telmai-api" id="trigger-job-using-telmai-api"></a>

To start scans from your own pipelines or orchestrators, such as Airflow, use the [Trigger Scan API](https://docs.telm.ai/telmai/api-reference/upload-data-api.md). Use [Track Scan Job](https://docs.telm.ai/telmai/api-reference/upload-data-api/track-job-status.md) to follow a scan's progress.
