# Custom Fields

Define workspace custom fields (text, large_text, number, dropdown, checkbox, date) that target projects, tasks, or members. This tag covers definition CRUD; the stored values are exposed read-only on the Projects, Tasks, and Members endpoints under the `custom_fields` property.

## List Custom Fields

 - [GET /custom-fields](https://api-docs.webwork-tracker.com/api/custom-fields/getcustomfields.md): List workspace custom-field definitions. Use the optional target filter to return only fields scoped to project, task, or member. Fields are owner-scoped. Access: higher-tier plan + Owner/Executive Manager.

## Create Custom Field

 - [POST /custom-fields](https://api-docs.webwork-tracker.com/api/custom-fields/createcustomfield.md): Define a new custom field. type and target are immutable after creation. For type: dropdown, options is required and must be a non-empty array of strings (max 10, each ≤255 chars); options are deduplicated and empties are stripped. A maximum of 20 fields per target is allowed. Access: higher-tier plan + Owner/Executive Manager.

## Get Single Custom Field

 - [GET /custom-fields/{field_id}](https://api-docs.webwork-tracker.com/api/custom-fields/getcustomfield.md): Retrieve a single custom field definition by its encrypted ID. Owner-scoped. Access: higher-tier plan + Owner/Executive Manager.

## Update Custom Field

 - [PUT /custom-fields/{field_id}](https://api-docs.webwork-tracker.com/api/custom-fields/updatecustomfield.md): Update a custom field definition. Only name and (for dropdown fields) options are editable — type and target are immutable and any attempt to change them returns 422. Access: higher-tier plan + Owner/Executive Manager.

## Delete Custom Field

 - [DELETE /custom-fields/{field_id}](https://api-docs.webwork-tracker.com/api/custom-fields/deletecustomfield.md): 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.