v1

latestOpenAPI 3.1.1Productboard Proprietary2026-07-2453178243.2 KB

fields

Delete field value

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.

delete/entities/fields/{id}/values/{valueId}

Path parameters

idstring required

Field identifier (UUID for custom fields, API name for default fields).

valueIdstring uuid required

A universally unique identifier (UUID).

Example:123e4567-e89b-12d3-a456-426614174000

The ID of the field value to delete.

Query parameters

forceboolean

When true, deletes the value and unsets it from all entities that currently use it. For multi-select fields, only this specific option is removed from each entity's selection. Mutually exclusive with replaceWith.

replaceWithstring uuid

A universally unique identifier (UUID).

Example:123e4567-e89b-12d3-a456-426614174000

ID of another value on the same field to reassign all current assignments to before deletion. Mutually exclusive with force.

Response

The request was successful and no content is returned.