---
title: "Starts a run"
method: POST
path: "/v1/session/run"
tags: ["Session"]
---

# Starts a run

`POST /v1/session/run`

## Request

- Base URL: `https://api.momentum-mod.org` (the document declares no server; this is the origin it was published from)
- URL: `https://api.momentum-mod.org/v1/session/run`
- Auth: HTTP bearer

## Request body

- CreateRunSessionDto
  - `mapID` number, required: ID of the map the run is on
  - `gamemode` 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13, required: Gamemode the run is on
  - `trackType` 0 | 1 | 2, required: The number of the track the run is on, relative to trackType
  - `trackNum` number, required: The number of the track the run is on, relative to trackType

## Response `200`

Run Session DTO, including the ID of the run to use on other run run endpoints

- RunSessionDto
  - `id` number, required
  - `mapID` number, required: ID of the map the run is on
  - `gamemode` 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13, required: Gamemode the run is on
  - `trackType` 0 | 1 | 2, required: The number of the track the run is on, relative to trackType
  - `trackNum` number, required: The number of the track the run is on, relative to trackType
  - `userID` number, required: The ID of the user submitting the run
  - `createdAt` string, required: When the item was first created, as ISO8601 date string

## Other responses

- `400`: Body is invalid

---

[API](https://skmtc.dev/momentum-mod/apis/momentum-mod-api.md) - [All operations](https://skmtc.dev/momentum-mod/apis/momentum-mod-api/llms.txt) - [OpenAPI document](https://skmtc.dev/momentum-mod/apis/momentum-mod-api/revisions/0a88cfbbcc65?raw)
