---
title: "Delete field value"
method: DELETE
path: "/entities/fields/{id}/values/{valueId}"
tags: ["fields"]
---

# Delete field value

`DELETE /entities/fields/{id}/values/{valueId}`

Deletes a value (option) from a select-type field (SINGLE_SELECT, MULTI_SELECT, TAG).

**STATUS fields are not supported.** Status values are managed through the status lifecycle
(not this endpoint) and cannot be deleted here.

By default, deletion is rejected if the value is currently assigned to any entities.
Use `force` to unset the value from all entities, or
`replaceWith` to move all assignments to another value.

These two parameters are mutually exclusive - providing both results in a 400 error.

## Path parameters

- `id` string, required
- `valueId` string, uuid, required — A universally unique identifier (UUID).

## Query parameters

- `force` boolean
- `replaceWith` string, uuid — A universally unique identifier (UUID).

## Response `204`

The request was successful and no content is returned.

## Other responses

- `400` — Bad Request - Invalid input format or malformed request
- `401` — Unauthorized - Missing or invalid authentication credentials
- `403` — Forbidden - Insufficient permissions
- `404` — Not Found - The requested resource does not exist or is not accessible
- `408` — Request Timeout - The server did not receive a complete request within the allowed time
- `422` — Unprocessable Entity - Validation failed (e.g., missing required fields, unknown fields)
- `429` — Too Many Requests - API rate limit exceeded, reduce request frequency and retry after the indicated time
- `500` — Internal Server Error - An unexpected error occurred on the server, please retry or contact support

---

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