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

Create a dropdown option on an Affinity list field, with text, rank, color or status.

Tool ID: affinity_v2_lists_list_id_fields_field_id_dropdown_options_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_post',
  {
    "listId": 123,
    "fieldId": "field_123",
    "type": "dropdown",
    "text": "example"
  },
);

console.log(result.toolResponse.raw);

CLI

deepline tools execute affinity_v2_lists_list_id_fields_field_id_dropdown_options_post --input '{
  "listId": 123,
  "fieldId": "field_123",
  "type": "dropdown",
  "text": "example"
}' --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_post --json for the complete live contract.

Input reference

Create a dropdown option for a List Field.

Name	Type	Required	Default	Details
`payload.listId`	`integer`	Yes	—	List ID Format: `int64`. Minimum: 1. Maximum: 9007199254740991.
`payload.fieldId`	`string`	Yes	—	Field ID
`payload.type`	`"dropdown" \| "ranked-dropdown" \| "status-dropdown"`	Yes	—	—
`payload.text`	`string`	Yes	—	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`	`object`	Yes	—	—
`result.data.id`	`integer`	Yes	—	Format: `int64`. Minimum: 1. Maximum: 9007199254740991.
`result.data.text`	`string`	Yes	—	—
`result.data.type`	`"dropdown" \| "ranked-dropdown" \| "status-dropdown"`	Yes	—	—
`result.data.rank`	`integer`	No	—	Format: `int32`. Minimum: 0. Maximum: 2147483647.
`result.data.color`	`"white" \| "gray" \| "blue" \| "green" \| "purple" \| "orange" \| "red" \| null`	No	—	—
`result.data.statusCategory`	`"open" \| "won" \| "lost" \| "on-hold"`	No	—	Allowed: `open`, `won`, `lost`, `on-hold`.
`result.data.winRate`	`integer \| null`	No	—	Format: `int32`. Minimum: 0. Maximum: 100.
`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.