---
title: "Run a schedule now"
method: POST
path: "/schedules/{id}/run"
tags: ["Schedules"]
---

# Run a schedule now

`POST /schedules/{id}/run`

## Request

- Base URL: `https://saturnsql.com/api`
- URL: `https://saturnsql.com/api/schedules/{id}/run`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer

Triggers an immediate run of a schedule (runs the saved query and exports to its destination), independent of its cadence. Takes no request body. Available to API keys with the `execute` scope.

## Path parameters

- `id` string, cuid, required

## Request body

- object: No body required — send an empty object or omit the body entirely.

## Response `200`

Ran

- object
  - `success` boolean
  - `spreadsheetUrl` string
  - `writtenRange` string
  - `slackDelivered` boolean

## Other responses

- `401`: Bad or missing credentials
- `404`: Schedule not found
- `500`: Export failed

---

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