> ## Documentation Index
> Fetch the complete documentation index at: https://docs.devhelm.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Synthetics

> Run browser journeys and multi-step API checks from a code bundle, then inspect run history and captured evidence

Use Synthetics to check a complete browser journey or a sequence of API requests. A monitor runs a Playwright test from a code bundle on a schedule, in the regions you select. Open its run history in the dashboard to investigate failures.

## Choose a check type

| Type | Use it for |
| - | - |
| Browser | Sign-in, signup, checkout, and other journeys that need a browser |
| Multi-step API | Authenticate, create a resource, read it back, and clean up without opening a browser |

A browser check uses the `BROWSER` monitor type. A multi-step API check uses `MULTI_STEP_API`. Your test code contains the assertions; these monitor types do not use the assertion editor for HTTP uptime monitors.

## Prepare the bundle

Keep the test and the local files it imports together. Choose the entrypoint by its relative path, such as `tests/checkout.spec.ts`. Upload that set with `POST /api/v1/bundles`. The response `data.digest` is the closure id. Use it as `code.bundle` when you create the monitor.

Keep credentials out of the bundle. Associate the monitor with an environment and bind the secret names DevHelm finds in the closure. The test reads its runtime variables through `process.env`.

> [!NOTE]
>
> Bundle upload uses the API. The dashboard provides monitor settings, bindings,
> revisions, and run evidence. The published CLI does not expose a bundle upload
> command.

Follow the [bundle upload workflow](https://docs.devhelm.io/synthetics/api-checks.md#upload-and-create-the-monitor). Browser checks use the same workflow with `type` set to `BROWSER` and a browser test entrypoint. Browser and multi-step API checks default to a 30 second timeout.

## Configure the schedule

Set the check frequency and selected regions when creating the monitor. You can inspect and change the schedule in the monitor's settings. Available regions and minimum intervals depend on your deployment and plan; see [probe regions](https://docs.devhelm.io/monitoring/regions.md) and the workspace's current limits.

Each selected region performs its own run. Increasing the number of regions or shortening the interval increases run usage. Browser and API checks use separate run allowances.

## Read a failed run

Open **Synthetics**, select the monitor, and open a run from its history. The run identifies its region, outcome, duration, and revision. Use the steps and evidence views to inspect the failure.

Browser evidence can include screenshots, video, a trace, network requests, console output, and runner logs. What is available depends on what the run captured and whether the artifact is still retained. The viewer distinguishes available, missing, and expired artifacts.

An API check reports its test outcome and recorded evidence. It does not produce browser screenshots or video. Put meaningful assertions and cleanup in the test so a failure identifies the request or condition that broke.

> [!NOTE]
>
> **Run now** starts an actual run and consumes usage. The uptime monitor's
> synchronous **Test** action is not available for Browser or Multi-step API
> monitors.

## Keep revisions reproducible

A revision records its digest, entrypoint, and file list. Optional source metadata records which commit produced it. Runs retain their revision reference, so you can compare failures without assuming they used the latest bundle.

> [card] [Multi-step API checks](https://docs.devhelm.io/synthetics/api-checks.md)
>
> Upload a bundle and create its monitor through the API.

> [card] [API authentication](https://docs.devhelm.io/authentication.md)
>
> Create a token for the workspace that owns your checks.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.