---
title: "Start - Start a new session"
method: GET
path: "/start/{kmID}"
tags: ["Decisions"]
---

# Start - Start a new session

`GET /start/{kmID}`

Start a session with the reasoning engine, specifying the knowledge map and (optionally) the version you require.<br><br> By default it will start a session using the live version. If no version has been set live it will default to the draft version.<br><br> Alternatively the query parameters “useDraft” or “version” can be used as an override to request either the draft or a specific version. We recommend using a new session for each query, unless you need to make multiple queries within the same context.

## Path parameters

- `kmID` string, required

## Query parameters

- `useDraft` boolean
- `version` integer

## Response `200`

Session start information

- object
  - `id` string — ID of newly created session
  - `kmVersion` object
    - `id` string — ID of the version being queried, which will be different to the knowledge map ID when querying live versions of a knowledge map

---

[API](https://skmtc.net/rainbird/apis/rainbird-api-documentation.md) · [All operations](https://skmtc.net/rainbird/apis/rainbird-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/rainbird/rainbird-api-documentation/revisions/0b8d2bc38f5d/schema)