---
title: "Delete opening"
method: DELETE
path: "/v3/openings/{id}"
tags: ["Openings"]
---

# Delete opening

`DELETE /v3/openings/{id}`

## Request

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

Permanently remove an opening from its job. Only closed openings with no attached offer and no filling application can be deleted — openings that are still `open`, or that were closed as a hire (`application_id` set), are protected and must remain on the job for record-keeping. To close an opening without removing it, use `PATCH /v3/openings/{id}` with `status: "closed"` instead.

## 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)