---
title: "Submit Controller"
method: POST
path: "/api/v1/models/train/new"
tags: ["Training"]
---

# Submit Controller

`POST /api/v1/models/train/new`

Model creation via API.

## Request body

- TrainRequestPayload
  - `dataset_id` string, required — The ID of the dataset to train the model on.
  - `predict_fields` string[], required — An array of field names to predict (case sensitive).
  - `ignore_fields` string[] — An array of field names to ignore (case sensitive).
  - `extra_attention` boolean — Helps with predicting rare cases.
  - `force` boolean — Forces the creation of a new model even if another currently exists.
  - `duration` integer, required — Integer corresponding to how much time we should spend on training. Higher values will take longer but generally be more accurate. Allowed values: 10 (Fastest), 60 (High Quality), 300 (Higher Quality), 1800 (Production)

## Response `201`

Successful Response

- APITaskStartedResponse
  - `task_id` string, required — The ID of the task that was started. This is generally queryable at a nearby `/status` endpoint to get the current status of the task.

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/akkio/apis/fastapi.md) · [All operations](https://skmtc.net/akkio/apis/fastapi/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/akkio/fastapi/versions/6662a407c637/schema)