---
title: "Delete custom field option"
method: DELETE
path: "/v3/custom_field_options/{id}"
tags: ["Custom Field Options"]
---

# Delete custom field option

`DELETE /v3/custom_field_options/{id}`

## Request

- Base URL: `https://harvest.greenhouse.io`
- URL: `https://harvest.greenhouse.io/v3/custom_field_options/{id}`
- Auth: one of:
  - OAuth 2
    - Authorization code: `https://auth.greenhouse.io/authorize`
    - Client credentials
    - Token URL: `https://auth.greenhouse.io/token` scopes: `harvest:custom_field_options:destroy`
  - HTTP bearer

Archive a custom field option so it can no longer be selected on new records. Deletes are soft: the row stays in the database with `active: false`, historical selections on candidates, jobs, and offers are preserved, and the option still appears in list responses unless the caller passes `active=true`. To restore an archived option, POST a new option with the original `name`. Deleting an option that is already archived succeeds and changes nothing, so retries and repeated ids within a bulk batch are safe.

## Path parameters

- `id` string, required

## Response `200`

Successful

- object
  - `id` integer
  - `created_at` string, date-time
  - `updated_at` string, date-time
  - `message` string

## Other responses

- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found

---

[API](https://skmtc.dev/greenhouse/apis/harvest-api.md) - [All operations](https://skmtc.dev/greenhouse/apis/harvest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/greenhouse/apis/harvest-api/revisions/822822e3f771?raw)