API reference / CRM
Add an option to a list's select column
Adds one option to a select or multi_select column, or finds the one already called that (whatever its case). Unlike changing the column's whole option list, it can't drop an option someone else added a moment ago.
/api/v1/lists/{id}/columns/{column}/optionsOther ways to call it
troopy lists add-optiontroopy_add_list_column_optionIdempotency-Key header. A retry with the same key gets the first answer back, and the operation runs one time.Path parameters
id*stringA 24-character id
column*stringAt most 40 characters
Body
application/jsonname*stringAt least 1 characters · At most 40 characters
colorenum<string>stoneskymintsandrosepeachcyanorange
Response
200 · application/jsondata*object8 properties
id*stringA standard column's field (name, email, title...) or c1, c2... for the list's own
name*stringtype*enum<string>textnumberdateselectmulti_selecturlcheckboxemailphonelong_text
options*array<object>3 properties
id*stringIts name: a select's value is its option's name
name*stringcolor*enum<string>stoneskymintsandrosepeachcyanorange
width*integerhidden*booleanstandard*booleanThe record's own field, the same on every list it is on; it can be hidden, not deleted
work*object | nullWhat it works out when it runs, for a work column; null for the rest
3 properties
kind*"ai"ask*stringWhat to work out for each row, in plain words
At least 1 characters · At most 1000 characters
read*booleanRead each row's website (its home, contact, about and team pages) first
Default false