clickup_get_list_custom_fields
Discover all custom fields available on a List, including inherited ones, and retrieve their IDs and option UUIDs to use when setting field values on tasks.
Instructions
List the Custom Fields accessible from a List.
Calls GET /list/{list_id}/field. This is the scope you almost always want
before setting a value: it returns every field usable on the List's tasks —
fields defined on the List plus those inherited from the parent Folder,
Space, and Workspace. Each field object carries the id (a UUID you pass to
clickup_set_custom_field_value), type, and type_config (for drop_down /
labels fields, type_config.options[] holds the option UUIDs you set).
When to Use:
To discover a field's
idand its option UUIDs before callingclickup_set_custom_field_valueon a task in this List.
When NOT to Use:
For fields defined higher up only: prefer the narrowest scope that includes your task. Use
clickup_get_folder_custom_fields,clickup_get_space_custom_fields, orclickup_get_team_custom_fieldsto inspect a specific level.
Returns:
A markdown list of fields (name, type, id, and any options) or, with
response_format="json", the raw field objects including full type_config.
Examples:
params = {"list_id": "901100154842"}
params = {"list_id": "901100154842", "include_applied_objects": true, "response_format": "json"}
Error Handling: 404 means the List id is wrong; 401/403 point to token or access issues.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| params | Yes |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |