---
title: "Start Rehearsal"
method: POST
path: "/suite/races/{race_id}/rehearsal"
tags: ["suite"]
---

# Start Rehearsal

`POST /suite/races/{race_id}/rehearsal`

## Request

- Base URL: `https://safefamilyapp.com` (the document declares no server; this is the origin it was published from)
- URL: `https://safefamilyapp.com/suite/races/{race_id}/rehearsal`
- Auth: HTTP bearer

Fire the gun on a rehearsal: real or synthetic runners, passings generated as the clock
moves. Needs a plan with a finish. Ends with DELETE, which removes every trace.

## Path parameters

- `race_id` string, required

## Request body

- RehearseIn
  - `synthetic_runners` integer
  - `started_minutes_ago` integer
  - `dnf_share` number
  - `seed` integer, nullable

## Response `200`

Successful Response

- SuiteRaceOut
  - `race_id` string, required
  - `event_id` string, required
  - `event_name` string, required
  - `course_name` string, required
  - `event_date` string, date, required
  - `distance_km` number, required
  - `elevation_gain_m` number, required
  - `has_gpx` boolean, required
  - `is_published` boolean, required
  - `status` string, required
  - `started_at` string, date-time, nullable, required
  - `finished_at` string, date-time, nullable, required
  - `settings` SuiteSettings, required
    - `timing` string
    - `organizer_phone` string, nullable
    - `bib_note` string, nullable
    - `bib_show_name` boolean
    - `bib_accent` string
    - `laps` integer
    - `planned_start` string, nullable
    - `live_public` boolean
    - `registration_open` boolean
    - `registration_limit` integer, nullable
    - `registration_note` string, nullable
    - `fee_text` string, nullable
    - `payment_url` string, nullable
    - `payment_instructions` string, nullable
    - `ask_club` boolean
    - `ask_birth_year` boolean
    - `ask_nationality` boolean
    - `ask_email` boolean
    - `require_emergency` boolean
    - `rehearsal` object, nullable
  - `participants` integer, required
  - `checkpoints` integer, required
  - `passings` integer, required

## Other responses

- `422`: Validation Error

---

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