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

 - [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/
 - [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
 - [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.
 - [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-ti
 - [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 M