---
updatedAt: 2026-06-24T08:24:02.000Z
---

Fetch the complete documentation index at: https://developer.connecteam.com/llms.txt. Use this file to discover all available pages before exploring further.

# Dropdown Options

Manage selectable values on **dropdown-type** questions within a form.

## Endpoints

| Method | Endpoint                                                           | Description      |
| :----- | :----------------------------------------------------------------- | :--------------- |
| GET    | /forms/v1/forms/{formId}/questions/{questionId}                    | List options     |
| POST   | /forms/v1/forms/{formId}/questions/{questionId}                    | Add options      |
| PUT    | /forms/v1/forms/{formId}/questions/{questionId}/options/{optionId} | Update an option |
| DELETE | /forms/v1/forms/{formId}/questions/{questionId}/options/{optionId} | Delete an option |

***

## Authentication

| Operation | Scope          |
| :-------- | :------------- |
| GET       | `forms.read`   |
| POST, PUT | `forms.write`  |
| DELETE    | `forms.delete` |

***

## GET — Query Parameters

| Parameter      | Type    | Required | Default | Description                   |
| :------------- | :------ | :------- | :------ | :---------------------------- |
| includeDeleted | boolean | No       | false   | Include soft-deleted options. |
| limit          | integer | No       | 10      | Max results. Range 1–500.     |
| offset         | integer | No       | 0       | Pagination offset.            |

***

## POST — Add Options

Appends new values; does not replace existing options. Duplicate values in one request are rejected.

```bash
curl --request POST \
  --url 'https://api.connecteam.com/forms/v1/forms/123456789/questions/abc123' \
  --header 'X-API-KEY: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{"dropdownOptions": [{"value": "Option A"}, {"value": "Option B"}]}'
```

## PUT — Update Option

Replaces the label of an existing option.

```bash
curl --request PUT \
  --url 'https://api.connecteam.com/forms/v1/forms/123456789/questions/abc123/options/opt456' \
  --header 'X-API-KEY: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{"value": "Updated label"}'
```

***

## Error Codes

| HTTP Status | Description                            |
| :---------- | :------------------------------------- |
| `400`       | Empty or duplicate option value.       |
| `401`       | Missing or invalid authentication.     |
| `403`       | Insufficient scope or form permission. |
| `404`       | Form, question, or option not found.   |
| `422`       | Question is not a dropdown type.       |

***

[Get dropdown options API Reference](https://developer.connecteam.com/reference/get_dropdown_question_options_forms_v1_forms__formid__questions__questionid__get)