---
title: "Update a dropdown option for a List Field"
method: POST
path: "/v2/lists/{listId}/fields/{fieldId}/dropdown-options/{dropdownOptionId}"
tags: ["Lists"]
---

# Update a dropdown option for a List Field

`POST /v2/lists/{listId}/fields/{fieldId}/dropdown-options/{dropdownOptionId}`

Update a dropdown option for a List Field.

## Path parameters

- `listId` integer, required
- `fieldId` string, required
- `dropdownOptionId` integer, required

## Request body

- union — - `dropdown` type field may update `text`. - `ranked-dropdown` type field may update `text`, `rank`, and/or `color`. - `status-dropdown` type field may update `text`, `rank`, `color`, `statusCategory`, and/or `winRate`.
  - DropdownOptionsStandardDropdownOptionToBeUpdated
    - `text` string — Dropdown option text
  - DropdownOptionsRankedDropdownOptionToBeUpdated
    - `text` string — Dropdown option text
    - `rank` integer — Dropdown option rank (sort order)
    - `color` 'white' | 'gray' | 'blue' | 'green' | 'purple' | 'orange' | 'red' — Dropdown option color
  - DropdownOptionsStatusDropdownOptionToBeUpdated
    - `text` string — Dropdown option text
    - `rank` integer — Dropdown option rank (sort order)
    - `color` 'white' | 'gray' | 'blue' | 'green' | 'purple' | 'orange' | 'red' — Dropdown option color
    - `statusCategory` 'open' | 'won' | 'lost' | 'on-hold' — Dropdown option's status category
    - `winRate` integer — The user-designated probability that an entity in this status will progress to a `won` status. Only valid when `statusCategory` is `open`. Must be an integer between 0 and 100 inclusive.

## Response `204`

No Content

## Other responses

- `400` — Bad Request
- `403` — Forbidden
- `404` — Not Found
- `default` — Errors

---

[API](https://skmtc.dev/affinity/apis/affinity-api-v2.md) · [All operations](https://skmtc.dev/affinity/apis/affinity-api-v2/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/affinity/affinity-api-v2/revisions/4c2891c31b7f/schema)