# 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

## Security:

  - `oauth2` (unknown)
    oauth2 scopes: write

  - `apiKey` (unknown)
    http bearer JWT

## Path parameters:

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

## Request fields (application/json):

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

## Response 200:

  - `200` (unknown)
    Custom field deleted successfully.

## Response 200 fields (application/json):

  - `success` (boolean)
    Example: true

  - `data` (object)
    Example: null

  - `message` (string)
    Example: Custom field deleted successfully

  - `meta` (object)

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

  - `meta.timestamp` (string)

## Response 400:

  - `400` (unknown)
    Bad request - invalid parameters or missing required fields

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

  - `401` (unknown)
    Authentication required - invalid or missing authentication token

## 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.documentation` (string)
    Link to the authentication docs. Only 401 responses include it.
    Example: https://api-docs.webwork-tracker.com/#authentication

## Response 403:

  - `403` (unknown)
    Access denied - insufficient permissions

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

  - `404` (unknown)
    Resource not found

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

  - `422` (unknown)
    Validation failed - request data is invalid

## Response 422 fields (application/json):

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

  - `errors` (object, required)
    Object containing validation error messages for each field
    Example: {"email":["The email field is required.","The email must be a valid email address."],"firstname":["The firstname field is required."],"role":["The selected role is invalid."]}

  - `meta` (object, required)

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

  - `meta.timestamp` (string)

## Response 500:

  - `500` (unknown)
    Internal server error - unexpected error occurred

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

## Response 400 examples:

  - `missing_workspace_id` (unknown)

  - `invalid_workspace_id` (unknown)

  - `invalid_pagination` (unknown)

## Response 404 examples:

  - `workspace_not_found` (unknown)

  - `member_not_found` (unknown)

  - `user_not_found` (unknown)