---
title: "Create new study"
method: POST
path: "/study"
tags: ["study"]
---

# Create new study

`POST /study`

Creates a new study. Upon success, it returns the study id.

## Query parameters

- `api_key` string, required

## Response `200`

Id of the uploaded study

- object
  - `upload_study` InlineResponse20025UploadStudy
    - `id` string — ID of the uploaded study, a positive integer

## Other responses

- `412` — Precondition failed. An error code and message are returned. 1031 - Description file not present. Please upload the study description. 1032 - Problem validating uploaded description file. The XML description format does not meet the standards. See the XSD schema. 1033 - Illegal main entity type. Currently only collections of tasks and can be created. 1034 - Linked entities are not of the correct type fot this study. 1035 - Benchmark suites can only be linked to run studies. 1036 - Referred benchmark suite cannot be found. 1037 - Referred benchmark suite should be a task collection. 1038 - Study alias is not unique. 1039 - Dataset insertion problem. Please contact the administrators.

---

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