Documentation

Delete field value

delete
https://api.productboard.com/v2/entities/fields//values/

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.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
string
required

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

uuid
required

The ID of the field value to delete.

Query Params
boolean
Defaults to false

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.

uuid

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

Responses
204

The request was successful and no content is returned.

Updated 15 days ago

Language
Credentials
Bearer
JWT
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated 15 days ago