curl --request POST \
  --url https://api.affinity.co/v2/lists/{listId}/fields/{fieldId}/dropdown-options/{dropdownOptionId} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "text": "Series A"
}
'

{
  "errors": [
    {
      "code": "bad-request",
      "message": "<string>"
    }
  ]
}

{
  "errors": [
    {
      "code": "authorization",
      "message": "<string>"
    }
  ]
}

{
  "errors": [
    {
      "code": "not-found",
      "message": "<string>"
    }
  ]
}

{
  "errors": [
    {
      "code": "authentication",
      "message": "<string>"
    }
  ]
}

Lists

Update a dropdown option for a List Field

⚠️ This endpoint is currently in BETA

Update a dropdown option for a List Field.

Note: Updating dropdown options on status fields is not yet supported. Requests where fieldId refers to a status field will return a 400 error.

POST

lists

{listId}

fields

{fieldId}

dropdown-options

{dropdownOptionId}

curl --request POST \
  --url https://api.affinity.co/v2/lists/{listId}/fields/{fieldId}/dropdown-options/{dropdownOptionId} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "text": "Series A"
}
'

{
  "errors": [
    {
      "code": "bad-request",
      "message": "<string>"
    }
  ]
}

{
  "errors": [
    {
      "code": "authorization",
      "message": "<string>"
    }
  ]
}

{
  "errors": [
    {
      "code": "not-found",
      "message": "<string>"
    }
  ]
}

{
  "errors": [
    {
      "code": "authentication",
      "message": "<string>"
    }
  ]
}

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

listId

integer<int64>

required

List ID

Required range: 1 <= x <= 9007199254740991

fieldId

string

required

Field ID

Example:

"field-1234"

Dropdown option ID

Required range: 1 <= x <= 9007199254740991

Body

application/json

dropdownOptions.StandardDropdownOptionToBeUpdated
dropdownOptions.RankedDropdownOptionToBeUpdated

dropdown type field may update text.
ranked-dropdown type field may update text, rank, and/or color.

text

string

Dropdown option text

Required string length: 1 - 255

Response

No Content

Get a dropdown option for a List Field Delete a dropdown option for a List Field

⌘I

Auth

Calls

Chat Messages

Companies

Company Merges

Emails

Feedback

Field Value Changes

Files

Inferred Connections

Lists

Meetings

Notes

Opportunities

Person Merges

Persons

Reminders

Semantic Search

Transcripts

Users

Update a dropdown option for a List Field

Authorizations

Path Parameters

Body

Response