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

# Run Schedule

`POST /schedules/{id}/run`

Run a schedule

## Path parameters

- `id` string, objectid, required — Schedule ID

## Request body

- RunScheduleInput
  - `cmd` string — Command
  - `mode` 'random' | 'all' | 'selected-nodes' | 'selected-node-groups' — Run mode
  - `node_group_ids` string[] — Node group IDs
  - `node_ids` string[] — Node IDs
  - `param` string — Parameters
  - `priority` integer — Priority

## Response `200`

OK

- ControllersResponseGoMongodbPrimitiveObjectID
  - `data` string[]
  - `error` string
  - `message` string
  - `status` string

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `500` — Internal Server Error

---

[API](https://skmtc.net/crawlab-team/apis/crawlab-api.md) · [All operations](https://skmtc.net/crawlab-team/apis/crawlab-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/crawlab-team/crawlab-api/versions/c7a4715c1f13/schema)