---
title: "Update custom field on a project"
method: PATCH
path: "/v1/workspaces/{workspaceId}/projects/{projectId}/custom-fields/{customFieldId}"
tags: ["Custom fields"]
---

# Update custom field on a project

`PATCH /v1/workspaces/{workspaceId}/projects/{projectId}/custom-fields/{customFieldId}`

## Path parameters

- `workspaceId` string, required — Represents a workspace identifier across the system.
- `projectId` string, required — Represents a project identifier across the system.
- `customFieldId` string, required — Represents a custom field identifier across the system.

## Request body

- CustomFieldProjectDefaultValuesRequest
  - `defaultValue` object — Represents a custom field's default value.
  - `status` 'INACTIVE' | 'VISIBLE' | 'INVISIBLE' — Represents a custom field status.

## Response `200`

OK

- CustomFieldDtoV1
  - `allowedValues` string[] — Represents a list of custom field's allowed values.
  - `description` string — Represents custom field description.
  - `entityType` string — Represents custom field entity type
  - `id` string — Represents custom field identifier across the system.
  - `name` string — Represents custom field name.
  - `onlyAdminCanEdit` boolean — Flag to set whether custom field is modifiable only by admin users.
  - `placeholder` string — Represents custom field placeholder value.
  - `projectDefaultValues` CustomFieldDefaultValuesDtoV1[] — Represents a list of custom field default values data transfer objects.
    - `projectId` string — Represents project identifier across the system.
    - `status` string — Represents custom field status
    - `value` object — Represents a custom field's default value
  - `required` boolean — Flag to set whether custom field is mandatory or not.
  - `status` string — Represents custom field status
  - `type` string — Represents custom field type.
  - `workspaceDefaultValue` object — Represents a custom field's default value in the workspace.
  - `workspaceId` string — Represents workspace identifier across the system.

---

[API](https://skmtc.dev/clockify/apis/clockify-api.md) · [All operations](https://skmtc.dev/clockify/apis/clockify-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/clockify/clockify-api/revisions/a5b636acbcd8/schema)