---
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

---

[API](https://skmtc.net/hf/apis/extralit-v1.md) · [All operations](https://skmtc.net/hf/apis/extralit-v1/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/hf/extralit-v1/versions/e9da3a893a88/schema)