Create custom field
create_custom_fieldCreate a custom field on a workspace, or REPLACE the options of one that already exists. Matching is by name: if a select field with this name exists, its option list is overwritten and every option missing from options is deleted, taking that value off every asset holding it. Always pass the complete intended option set, and check list_custom_fields first when the field may already exist. The workspace's built-in 'Status' field cannot be replaced through this tool; use update_asset_status to assign its value to an asset. For a select field (the default) or a multi_select field options cannot be empty. For a date, person, url or text field pass field_type and no options; an existing field with the same name and type is returned unchanged, and a name already used by a field of another type is refused. A NEW field is refused once the workspace reaches its plan's custom field quota — replacing the options of an existing field still works at the limit, so check list_custom_fields before assuming the workspace needs another field. A field's VALUE is set on an asset with update_asset's fields argument ({ "Priority": "High" }); there is no separate set-value tool. Field and option names are matched EXACTLY; update_asset answers an unknown one with an error naming the valid ones, and list_custom_fields has the spelling. Requires a write-scope token and workspace owner/admin permission.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"name": "<name>"
},
"name": "create_custom_field"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | Yes | Field name, e.g. 'Priority'. An existing field with this name is reused and its options replaced. The built-in 'Status' field is protected and cannot be replaced. | |
| options | No | The complete set of values a select or multi_select field allows, e.g. ['Low', 'Medium', 'High']. Replaces the existing options; anything omitted is deleted. Required and non-empty for those; omit it for date, person, url and text fields. | |
| field_type | No | What the field holds: 'select' (default) for one of a fixed set of options, 'multi_select' for any number of them, 'date' for an ISO date, 'person' for a workspace member, 'url' for a link, 'text' for one line of free text. Cannot be changed later, except that a select field can become multi_select. | |
| organization | No | Workspace slug, as returned by list_organizations. Omit it when the account has a single workspace — it is then resolved from your token. Pass it only when the account has several, or when you mean a workspace other than the obvious one. |