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

# Upload a flow

`POST /flow`

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

## Query parameters

- `api_key` string, required

## Response `200`

Id of the uploaded flow

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

## Other responses

- `160` — Error in file uploading. There was a problem with the file upload.
- `161` — Please provide description xml.
- `163` — Problem validating uploaded description file. The XML description format does not meet the standards.
- `164` — Flow already stored in database. Please change name or version number
- `165` — Failed to insert flow. There can be many causes for this error. If you included the implements field, it should be an existing entry in the algorithm or math_function table. Otherwise it could be an internal server error. Please contact API support team.
- `166` — Failed to add flow to database. Internal server error, please contact API administrators
- `167` — Illegal files uploaded. An non required file was uploaded.
- `168` — The provided md5 hash equals not the server generated md5 hash of the file.
- `169` — Please provide API key. In order to share content, please authenticate and provide API key.
- `170` — Authentication failed. The API key was not valid. Please try to login again, or contact API administrators
- `171` — Flow already exists. This flow is already in the database
- `172` — XSD not found. Please contact API support team

## Changes

- **2018-01-17** `2209d99ea36e` — 13 info
  - added the non-success response with the status `160`
  - added the non-success response with the status `161`
  - added the non-success response with the status `163`
  - added the non-success response with the status `164`
  - …9 more

[Change history](https://skmtc.dev/openml/apis/openml-api/changes/flow/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/2209d99ea36e/schema)