---
title: "Delete field"
method: DELETE
path: "/v1/fields/{field_id}"
tags: ["Fields"]
---

# Delete field

`DELETE /v1/fields/{field_id}`

Delete a field by id. This is a soft delete.

> 🚧 Permissions
>
> Please check you have the relevant permissions required to access this resource. This may include specific permissions on the object itself or its parent, or having the correct user role if you're making updates.

## Path parameters

- `field_id` string, required

## Request body

- object

## Response `200`

200

- object
  - `data` object, required
    - `id` string, required
    - `type` 'field', required
    - `label` string, required
    - `field_type` 'ARR' | 'BOOLEAN' | 'CSAT' | 'DATETIME' | 'EMAIL' | 'MULTI_SELECT' | 'NPS' | 'NUMBER' | 'PERSON' | 'PHONE' | 'RATING' | 'SINGLE_SELECT' | 'TEXT' | 'URL', required
    - `field_set_type` 'data' | 'doc', required
    - `project_id` string, required
    - `rank` number, required
    - `options` union, required
      - string[]
      - object
        - `format` string, nullable
        - `currency_symbol` string, nullable
    - `created_at` string, required
    - `deleted` boolean, required

## Other responses

- `400` — 400
- `401` — 401
- `403` — 403
- `404` — 404
- `422` — 422
- `429` — 429
- `500` — 500

---

[API](https://skmtc.net/dovetail/apis/dovetail-public-api.md) · [All operations](https://skmtc.net/dovetail/apis/dovetail-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/dovetail/dovetail-public-api/revisions/4107f5fdf8b2/schema)