---
title: "Create a new dataset"
method: POST
path: "/datasets"
tags: ["datasets"]
---

# Create a new dataset

`POST /datasets`

Creates a new dataset

## Request body

- CreateDatasetRequest
  - `name` string, required — Name of the dataset.

## Response `200`

Dataset created successfully

- Dataset — A dataset for organizing training images.
  - `dataset_id` string, required — Unique identifier for the dataset.
  - `name` string, required — Display name of the dataset.
  - `user_id` string, required — ID of the user who owns this dataset.
  - `creation_time` string, date-time, required — When the dataset was created.
  - `cover_asset_identifier` DatasetCoverAssetIdentifier — An identifier for an ideogram asset.
    - `asset_type` 'ASSET' | 'CANVAS_ASSET' | 'LAYERED_ASSET' | 'RESPONSE' | 'UPLOAD', required
    - `asset_id` string, required

## Other responses

- `400` — Bad request
- `401` — Unauthorized

## Changes

- **2026-09-02** `1429d75daa36` — 4 breaking, 1 info
  - the response property `cover_asset_identifier` became nullable for the status `200`
  - the `cover_asset_identifier` response's property type changed from `object` to no type for status `200`
  - removed the required property `cover_asset_identifier/asset_id` from the response with the `200` status
  - removed the required property `cover_asset_identifier/asset_type` from the response with the `200` status
  - …1 more

[Change history](https://skmtc.dev/ideogram/apis/ideogram-openapi-3-0/changes/datasets/post.md)

---

[API](https://skmtc.dev/ideogram/apis/ideogram-openapi-3-0.md) · [All operations](https://skmtc.dev/ideogram/apis/ideogram-openapi-3-0/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/ideogram/ideogram-openapi-3-0/revisions/1429d75daa36/schema)