---
title: "Preview Pipeline Schedule Handler"
method: POST
path: "/api/pipelines/schedule/preview"
tags: ["runtime_mutations", "pipelines"]
---

# Preview Pipeline Schedule Handler

`POST /api/pipelines/schedule/preview`

Validate a draft schedule and return its next fire times.

Invalid drafts are a normal 200 so the editor renders the error inline
while the user types, not as a failed-request toast.

## Request body

- SchedulePreviewPayload
  - `cron` string, required
  - `timezone` string

## Response `200`

Successful Response

- unknown

## Other responses

- `422` — Validation Error

## Changes

- **2026-09-18** `abf76937a751` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/quadrillion/apis/quadrillion-cloud-api/changes/api/pipelines/schedule/preview/post.md)

---

[API](https://skmtc.dev/quadrillion/apis/quadrillion-cloud-api.md) · [All operations](https://skmtc.dev/quadrillion/apis/quadrillion-cloud-api/llms.txt) · [OpenAPI document](https://skmtc.dev/quadrillion/apis/quadrillion-cloud-api/revisions/397ad3a1d858?raw)