---
title: "Upsert Pipeline Schedule Handler"
method: PUT
path: "/api/pipelines/{rule_id}/schedule"
tags: ["runtime_mutations", "pipelines"]
---

# Upsert Pipeline Schedule Handler

`PUT /api/pipelines/{rule_id}/schedule`

## Path parameters

- `rule_id` string, required

## Request body

- SchedulePayload
  - `cron` string, required
  - `timezone` string
  - `enabled` boolean
  - `ends_at` string, date-time, nullable
  - `remaining_runs` integer, nullable

## 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/:rule_id/schedule/put.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/d61e2ec5a271?raw)