---
title: "Archive dropdown options"
method: POST
path: "/dropdowns/{dropdown_id}/options:archive"
tags: ["dropdowns"]
---

# Archive dropdown options

`POST /dropdowns/{dropdown_id}/options:archive`

## Request

- Base URL: `https://{tenant_name}.benchling.com/api/v2`
- URL: `https://{tenant_name}.benchling.com/api/v2/dropdowns/{dropdown_id}/options:archive`
- Auth: HTTP bearer

Archive options belonging to a dropdown

## Path parameters

- `dropdown_id` string, required

## Request body

- DropdownOptionsArchive
  - `dropdownOptionIds` string[]: Array of dropdown option IDs
  - `reason` 'Made in error' | 'Retired' | 'Other': Reason that dropdown options are being archived.

## Response `200`

OK

- DropdownOptionsArchivalChange: IDs of all items that were archived or unarchived.
  - `dropdownOptionIds` string[]

## Other responses

- `400`: Bad Request
- `403`: Forbidden
- `404`: Not Found

---

[API](https://skmtc.dev/benchling/apis/benchling-api-2.md) - [All operations](https://skmtc.dev/benchling/apis/benchling-api-2/llms.txt) - [OpenAPI document](https://skmtc.dev/benchling/apis/benchling-api-2/revisions/01d2fa8523cd?raw)
