---
title: "Deleting a Property"
method: DELETE
path: "/v1/projects/{projectId}/datasets/{name}/properties/{propertyName}"
tags: ["Dataset Management"]
---

# Deleting a Property

`DELETE /v1/projects/{projectId}/datasets/{name}/properties/{propertyName}`

_(introduced: version 2026.1)_

Deletes a published Property from a Dataset. The deletion is permanent, but a new property with the same name can easily be re-added.

A Property cannot be deleted if either of the following is true:
- Any published or draft Forms are currently writing to it (i.e. they have a `save_to` mapping to this Property). Those Forms must be updated or deleted first.
- Any Entities have a non-empty value for it. Those Entity values must be cleared first by updating each Entity to have an empty string for that Property.

If deletion is blocked, the 409 response includes a `details.prerequisites` object describing what needs to be resolved. For blocked Forms, it includes a list of the dependent Form IDs and names. For blocked Entities, it includes a `totalCount` and up to 3 example Entity UUIDs and labels.

A Form that reads a Dataset Property via an attachment may break after deleting the Property, so check any Forms that consume this Dataset as well.

## Path parameters

- `projectId` number, required
- `name` string, required
- `propertyName` string, required

## Response `200`

OK

- Success
  - `success` boolean, required

## Other responses

- `409` — Conflict

## Changes

- **2026-04-03** `2aed27d9e013` — 1 info
  - endpoint added
- **2025-03-13** `e8c2858fd4eb` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/getodk/apis/odk-central-api/changes/v1/projects/:projectId/datasets/:name/properties/:propertyName/delete.md)

---

[API](https://skmtc.dev/getodk/apis/odk-central-api.md) · [All operations](https://skmtc.dev/getodk/apis/odk-central-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/getodk/odk-central-api/revisions/dc3ccc706398/schema)