---
title: "Create a cron schedule that fires runs on the graph."
method: POST
path: "/graphs/{graphId}/schedules"
tags: ["schedules"]
---

# Create a cron schedule that fires runs on the graph.

`POST /graphs/{graphId}/schedules`

## Request

- Base URL: `https://api.livegraph.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.livegraph.ai/graphs/{graphId}/schedules`
- Auth: one of:
  - API key in cookie `livegraph_session`
  - API key in header `x-api-key`

## Path parameters

- `graphId` string, uuid, required

## Request body

- object
  - `name` string, required
  - `input` unknown, required
  - `cronExpression` string, required
  - `mode` 'pinned' | 'live'
  - `enabled` boolean
  - `quiet` boolean
  - `queueGate` object, nullable
    - `repo` string, required
    - `branchPrefix` string
    - `signal` boolean
    - `baseBranch` string
    - `path` string
    - `idPrefix` string
    - `wipLimit` integer
    - `dailyCap` integer
    - `dailyUsd` number
    - `refillNodeId` string, uuid
    - `lowWaterMark` integer
    - `artifactDir` string

## Response `200`

Success — see summary for the response shape.

## Other responses

- `4XX`: Client error — body is the shared {error, code?} envelope.

## Changes

- **2026-10-19** `551085d7719e`: 2 info
  - added the new optional request property `queueGate/anyOf[subschema #1]/signal`
  - the request property `queueGate/anyOf[subschema #1]/branchPrefix` became optional

[Operation history](https://skmtc.dev/livegraph/apis/livegraph-api/changes/graphs/:graphId/schedules/post.md)

---

[API](https://skmtc.dev/livegraph/apis/livegraph-api.md) · [All operations](https://skmtc.dev/livegraph/apis/livegraph-api/llms.txt) · [OpenAPI document](https://skmtc.dev/livegraph/apis/livegraph-api/revisions/551085d7719e?raw)