---
title: "Upload a new user-defined dataset, which defines a bundle of one or more plot observations"
method: POST
path: "/user-datasets"
tags: ["User Datasets"]
---

# Upload a new user-defined dataset, which defines a bundle of one or more plot observations

`POST /user-datasets`

## Response `200`

completed

- string[]

## Other responses

- `403` — Uploads not allowed
- `500` — Invalid data upload

## Changes

> 32 revisions in range; 1 not diffed.

- **2026-03-02** `8abfd084d7aa` — 1 breaking
  - the `items/` request property type changed from no type to `object`
- **2026-01-27** `09715976af2b` — 1 info
  - endpoint added
- **2025-04-29** `c9e23cb778c9` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/nceas/apis/vegbankapi/changes/user-datasets/post.md)

---

[API](https://skmtc.dev/nceas/apis/vegbankapi.md) · [All operations](https://skmtc.dev/nceas/apis/vegbankapi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/nceas/vegbankapi/revisions/8abfd084d7aa/schema)