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

# Submit Controller

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

## Request

- Base URL: `https://api.akkio.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.akkio.com/api/v1/models/train/new`
- Auth: none declared

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.dev/akkio/apis/akkio-api.md) - [All operations](https://skmtc.dev/akkio/apis/akkio-api/llms.txt) - [OpenAPI document](https://skmtc.dev/akkio/apis/akkio-api/revisions/c477deff6271?raw)