Affinity: V2 Lists List ID Fields Field ID Dropdown Options Dropdown Option ID Post - Deepline

Update a dropdown option on an Affinity list field: its text, rank, color, status category or win rate.

Tool ID: affinity_v2_lists_list_id_fields_field_id_dropdown_options_dropdown_option_id_post

Run this action

Use the TypeScript SDK for one call. Use ctx.tools.execute(...) inside a Play for durable calls, scheduled calls, or CSV processing.

import { Deepline } from 'deepline';

const deepline = await Deepline.connect();
const result = await deepline.tools.execute(
  'affinity_v2_lists_list_id_fields_field_id_dropdown_options_dropdown_option_id_post',
  {
    "listId": 123,
    "fieldId": "field_123",
    "dropdownOptionId": 123
  },
);

console.log(result.toolResponse.raw);

CLI

deepline tools execute affinity_v2_lists_list_id_fields_field_id_dropdown_options_dropdown_option_id_post --input '{
  "listId": 123,
  "fieldId": "field_123",
  "dropdownOptionId": 123
}' --json

Example response

The static output schema lacks the details for a reliable example. Use deepline describe affinity_v2_lists_list_id_fields_field_id_dropdown_options_dropdown_option_id_post --json for the complete live contract.

Input reference

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.

Name	Type	Required	Default	Details
`payload.listId`	`integer`	Yes	—	List ID Format: `int64`. Minimum: 1. Maximum: 9007199254740991.
`payload.fieldId`	`string`	Yes	—	Field ID
`payload.dropdownOptionId`	`integer`	Yes	—	Dropdown option ID Format: `int64`. Minimum: 1. Maximum: 9007199254740991.
`payload.text`	`string`	No	—	Dropdown option text Minimum length: 1. Maximum length: 255.
`payload.rank`	`integer`	No	—	Dropdown option rank (sort order) Format: `int32`. Minimum: 0. Maximum: 2147483647.
`payload.color`	`"white" \| "gray" \| "blue" \| "green" \| "purple" \| "orange" \| "red"`	No	—	Dropdown option color Allowed: `white`, `gray`, `blue`, `green`, `purple`, `orange`, `red`.
`payload.statusCategory`	`"open" \| "won" \| "lost" \| "on-hold"`	No	—	Dropdown option’s status category Allowed: `open`, `won`, `lost`, `on-hold`.
`payload.winRate`	`integer`	No	—	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. Format: `int32`. Minimum: 0. Maximum: 100.

Output reference

Name	Type	Required	Default	Details
`result.data`	`unknown`	Yes	—	—
`result.meta`	`object`	No	—	—

Deepline cost

Pricing model: fixed (per call).
Estimated Deepline credits: 0 per pricing unit.
Provider-native pricing may still exist outside Deepline credit billing.