---
title: "Run Scheduled Simulation"
method: POST
path: "/v1/internal/run-scheduled-simulation"
---

# Run Scheduled Simulation

`POST /v1/internal/run-scheduled-simulation`

Internal fire endpoint for the cron service (simulation-cron-service).

Auth is the inbound counterpart to weekly_notifications' outbound X-Internal-Token.
run_simulation_now is fire-and-forget; we 202 on accept. A 404 it raises is a
permanent failure (sim/test cases gone) — propagate it so the cron side stops retrying.

## Headers

- `x-internal-token` string
- `X-API-Key` string, required

## Request body

- RunScheduledSimulationRequest
  - `simulation_id` string, required
  - `uptime_check_id` string, nullable

## Response `202`

Successful Response

- unknown

## Other responses

- `422` — Validation Error

## Changes

- **2026-07-26** `44d183272ce1` — 1 info
  - added the new optional request property `uptime_check_id`

[Change history](https://skmtc.dev/getbluejay/apis/bluejay-api/changes/v1/internal/run-scheduled-simulation/post.md)

---

[API](https://skmtc.dev/getbluejay/apis/bluejay-api.md) · [All operations](https://skmtc.dev/getbluejay/apis/bluejay-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/getbluejay/bluejay-api/revisions/bf69ab7268a4/schema)