---
title: "Create Dataset Metadata Property"
method: POST
path: "/datasets/{dataset_id}/metadata-properties"
tags: ["datasets"]
---

# Create Dataset Metadata Property

`POST /datasets/{dataset_id}/metadata-properties`

## Path parameters

- `dataset_id` string, uuid, required

## Request body

- MetadataPropertyCreate
  - `name` string, required
  - `title` string, required — The title of the metadata property
  - `settings` union, required
    - TermsMetadataPropertyCreate
      - `type` 'terms', required
      - `values` unknown[], nullable
        - unknown
    - IntegerMetadataPropertyCreate
      - `min` integer, nullable
      - `max` integer, nullable
      - `type` 'integer', required
    - FloatMetadataPropertyCreate
      - `min` number, nullable
      - `max` number, nullable
      - `type` 'float', required
  - `visible_for_annotators` boolean

## Response `201`

Successful Response

- MetadataProperty
  - `id` string, uuid, required
  - `name` string, required
  - `title` string, required
  - `settings` union, required
    - TermsMetadataProperty
      - `type` 'terms', required
      - `values` unknown[], nullable
        - unknown
    - IntegerMetadataProperty
      - `type` 'integer', required
      - `min` integer, nullable
      - `max` integer, nullable
    - FloatMetadataProperty
      - `type` 'float', required
      - `min` number, nullable
      - `max` number, nullable
  - `visible_for_annotators` boolean, required
  - `dataset_id` string, uuid, required
  - `inserted_at` string, date-time, required
  - `updated_at` string, date-time, required

## Other responses

- `400` — Bad Request
- `403` — Forbidden
- `404` — Not Found
- `409` — Conflict
- `422` — Unprocessable Content
- `500` — Internal Server Error

## Changes

- **2026-08-24** `ca32894f988c` — 3 breaking, 3 info
  - removed the enum value `float` of the request property `settings/oneOf[subschema #3: FloatMetadataPropertyCreate]/type`
  - removed the enum value `integer` of the request property `settings/oneOf[subschema #2: IntegerMetadataPropertyCreate]/type`
  - removed the enum value `terms` of the request property `settings/oneOf[subschema #1: TermsMetadataPropertyCreate]/type`
  - removed the `float` enum value from the `settings/oneOf[subschema #3: FloatMetadataProperty]/type` response property for the response status `201`
  - …2 more

[Change history](https://skmtc.dev/hf/apis/extralit-v1/changes/datasets/:dataset_id/metadata-properties/post.md)

---

[API](https://skmtc.dev/hf/apis/extralit-v1.md) · [All operations](https://skmtc.dev/hf/apis/extralit-v1/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/hf/extralit-v1/revisions/ca32894f988c/schema)