---
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` InlineResponse20015UploadFlow
    - `id` string — ID of the uploaded run, a positive integer

## Other responses

- `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

- **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/4df86fe63217/schema)