---
title: "Run a scheduled task now, bypassing its schedule and skip guard"
method: POST
path: "/scheduled-tasks/{scheduledTaskId}/run"
tags: ["scheduled-tasks"]
---

# Run a scheduled task now, bypassing its schedule and skip guard

`POST /scheduled-tasks/{scheduledTaskId}/run`

## Request

- Base URL: `https://api.letsship.ai/v1`
- URL: `https://api.letsship.ai/v1/scheduled-tasks/{scheduledTaskId}/run`
- Auth: none declared

## Path parameters

- `scheduledTaskId` string, required

## Response `200`

Dispatched

- RunScheduledTaskResponse
  - `ok` boolean, required
  - `runId` string, required
  - `issueId` string, nullable, required
  - `status` 'dispatching' | 'dispatched' | 'skipped' | 'failed', required

## Other responses

- `403`: Role or scope insufficient
- `404`: Not found
- `409`: Slot already claimed

---

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