---
title: "Upload run"
method: POST
path: "/run"
tags: ["run"]
---

# Upload run

`POST /run`

Uploads a run. Upon success, it returns the run id.

## Query parameters

- `api_key` string, required

## Response `200`

Id of the uploaded run

- object
  - `upload_flow` InlineResponse20018UploadFlow
    - `id` string — ID of the uploaded run, a positive integer

## Other responses

- `412` — Precondition failed. An error code and message are returned. 201 - Authentication failed. The API key was not valid. Please try to login again, or contact api administrators. 202 - Please provide run XML. 203 - Could not validate run xml by XSD. Please double check that the xml is valid. 204 - Unknown task. The task with the given ID was not found in the database. 205 - Unknown flow. The flow with the given ID was not found in the database. 206 - Invalid number of files. The number of uploaded files did not match the number of files expected for the task type 207 - File upload failed. One of the files uploaded has a problem. 208 - Error inserting setup record. Please contact api administrators 210 - Unable to store run. Please contact api administrators. 211 - Dataset not in database. One of the datasets of the task was not included in database, please contact api administrators. 212 - Unable to store file. Please contact api administrators. 213 - Parameter in run xml unknown. One of the parameters provided in the run xml is not registered as parameter for the flow nor its components. 214 - Unable to store input setting. Please contact API support team. 215 - Unable to evaluate predictions. Please contact API support team. 216 - Error thrown by Java Application. Additional information field is provided. 217 - Error processing output data. Unknown or inconsistent evaluation measure. One of the provided evaluation measures could not be matched with a record in the math_function or flow table. 218 - Wrong flow associated with run. The flow implements a math_function, which is unable to generate predictions. Please select another flow. 219 - Error reading the XML document. The XML description file could not be verified.

## Changes

> 14 revisions in range; 1 could not be searched.

- **2019-02-22** `8e2f718635ef` — 18 breaking, 1 info
  - removed the success response with the status `201`
  - removed the success response with the status `202`
  - removed the success response with the status `203`
  - removed the success response with the status `204`
  - …15 more
- **2018-01-17** `2209d99ea36e` — 19 info
  - removed the non-success response with the status `412`
  - added the success response with the status `201`
  - added the success response with the status `202`
  - added the success response with the status `203`
  - …15 more

[Change history](https://skmtc.dev/openml/apis/openml-api/changes/run/post.md)

---

[API](https://skmtc.dev/openml/apis/openml-api.md) · [All operations](https://skmtc.dev/openml/apis/openml-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/openml/openml-api/revisions/263d3d6ee586/schema)