# Delete Custom Field

Delete a custom field definition. **All values stored under this field on every project/task/member are also deleted (cascade)**. This is irreversible. **Access**: higher-tier plan + Owner/Executive Manager.

Endpoint: DELETE /custom-fields/{field_id}
Version: 2.0.0
Security: oauth2, apiKey

## Path parameters:

  - `field_id` (string, required)
    Encrypted custom field ID.

## Request fields (application/json):

  - `workspace_id` (integer, required)
    Example: 1

## Response 200 fields (application/json):

  - `success` (boolean)
    Example: true

  - `data` (object)
    Example: null

  - `meta` (object)

  - `meta.api_version` (string)
    Example: 2.0.0

  - `meta.timestamp` (string)

## Response 400 fields (application/json):

  - `success` (boolean, required)
    Example: false

  - `error` (string, required)
    Error message describing what went wrong (single-message errors: 400/401/403/404/500). Validation failures (422) use the `errors` map instead — see ValidationErrorResponse.
    Example: Shift not found

  - `meta` (object, required)

  - `meta.api_version` (string)
    Example: 2.0.0

  - `meta.timestamp` (string)

## Response 401 fields (application/json):

  - `success` (boolean, required)
    Example: false

  - `error` (string, required)
    Error message describing what went wrong (single-message errors: 400/401/403/404/500). Validation failures (422) use the `errors` map instead — see ValidationErrorResponse.
    Example: Shift not found

  - `meta` (object, required)

  - `meta.api_version` (string)
    Example: 2.0.0

  - `meta.timestamp` (string)

## Response 403 fields (application/json):

  - `success` (boolean, required)
    Example: false

  - `error` (string, required)
    Error message describing what went wrong (single-message errors: 400/401/403/404/500). Validation failures (422) use the `errors` map instead — see ValidationErrorResponse.
    Example: Shift not found

  - `meta` (object, required)

  - `meta.api_version` (string)
    Example: 2.0.0

  - `meta.timestamp` (string)

## Response 404 fields (application/json):

  - `success` (boolean, required)
    Example: false

  - `error` (string, required)
    Error message describing what went wrong (single-message errors: 400/401/403/404/500). Validation failures (422) use the `errors` map instead — see ValidationErrorResponse.
    Example: Shift not found

  - `meta` (object, required)

  - `meta.api_version` (string)
    Example: 2.0.0

  - `meta.timestamp` (string)

## Response 422 fields (application/json):

  - `success` (boolean, required)
    Example: false

  - `meta` (object, required)

  - `meta.api_version` (string)
    Example: 2.0.0

  - `meta.timestamp` (string)

## Response 500 fields (application/json):

  - `success` (boolean, required)
    Example: false

  - `error` (string, required)
    Error message describing what went wrong (single-message errors: 400/401/403/404/500). Validation failures (422) use the `errors` map instead — see ValidationErrorResponse.
    Example: Shift not found

  - `meta` (object, required)

  - `meta.api_version` (string)
    Example: 2.0.0

  - `meta.timestamp` (string)