---
title: "Start Run For Training"
method: POST
path: "/api/train/trainings/{training_id}/run"
tags: ["train"]
---

# Start Run For Training

`POST /api/train/trainings/{training_id}/run`

## Request

- Base URL: `https://app.getdot.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://app.getdot.ai/api/train/trainings/{training_id}/run`
- Auth: one of:
  - API key in header `X-API-KEY`
  - API key in cookie `Authorization`
  - OAuth 2 (password, token URL `/api/auth/token`)

## Path parameters

- `training_id` string, required

## Request body

- StartTrainingRunRequest
  - `config` PublicTrainingRunConfig
    - `name` string, nullable
    - `credit_limit_acc` integer, nullable
    - `evaluation_name` string, nullable
    - `target_score_pct` integer
    - `ground_truth_values` GroundTruthValueRequest[], nullable
      - `metric` string, required
      - `question` string, nullable
      - `value` string, required
      - `period` string, nullable
      - `answer_type` 'number' | 'currency' | 'percent' | 'count' | 'ratio' | 'date'
      - `unit` string, nullable
      - `tolerance_pct` number
      - `category` string, nullable
      - `source` PublicQuestionSource
        - `system` string, nullable
        - `workbook` string, nullable
        - `view` string, nullable
        - `dashboard_name` string, nullable
        - `dashboard_url` string, nullable
        - `dashboard_id` string, nullable
        - `tile_id` string, nullable
        - `look_id` string, nullable
        - `query_id` string, nullable
        - `method` 'tile_read' | 'reconstructed', nullable
        - `reconstruction_accepted` boolean, nullable
        - `compiled_sql` string, nullable
        - `filters` object
        - `question_filters` object, nullable
        - `extracted_at` string, nullable
        - `definition` string, nullable
        - `legacy_run_status` string, nullable
        - `legacy_run_id` string, nullable
        - `connection_id` string, nullable
        - `worksheet` string, nullable
        - `category` string, nullable
        - `expected_period` string, nullable
        - `metric` string, nullable
    - `source_chat_id` string, nullable
    - `start_from` TrainingStartPoint
      - `kind` 'inherit' | 'production' | 'environment'
      - `environment_id` string, nullable
    - `guidance` string, nullable
    - `fast` boolean

## Response `200`

Successful Response

- object

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/getdot/apis/dot-api-2.md) · [All operations](https://skmtc.dev/getdot/apis/dot-api-2/llms.txt) · [OpenAPI document](https://skmtc.dev/getdot/apis/dot-api-2/revisions/d26fe7163a7f?raw)