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

# Update field value

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

Updates an existing value (option) for a select-type field (SINGLE_SELECT, MULTI_SELECT, TAG).
Only provided fields are updated, omitted fields remain unchanged.

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

## Path parameters

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

## Request body

- object
  - `data` object, required
    - `fields` object — Attributes to update. Omitted fields remain unchanged.
      - `name` string — Updated display name of the select option.
      - `color` 'red' | 'blue' | 'green' | 'yellow' | 'purple' | 'gray' | 'lime' | 'pink' — Named color for a select option.

## Response `200`

Field value created or updated successfully

- object
  - `data` object
    - `id` string, uuid, required — A universally unique identifier (UUID).
    - `links` ResourceLinks
      - `self` string, required

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