Custom fields
Every Custom fields tool, with the scope it needs, its arguments and the API operation it calls.
4 tools
Create field definitions
Changes dataatlas_fields_definitions_create
Create a new custom field with optional typed validation rules (text minLen/maxLen/regex, number min/max/step, date min/max, select required-from-list, multi-select min/max items, currency currency-code, url protocol-allowlist).
- Scope
tasks:write- Calls
- Example prompt
- Add a Severity number field on the Atlas project, between 1 and 5.
Arguments
| Field | Type | Required | Description |
|---|---|---|---|
projectId | string | Yes | |
key | string | Yes | Stable lowercase key, 2-39 chars. |
name | string | Yes | |
description | string | No | |
kind | "TEXT" | "PARAGRAPH" | "NUMBER" | "SELECT" | "MULTI_SELECT" | "DATE" | "DATE_RANGE" | "USER" | "USERS" | "URL" | "CHECKBOX" | "ATTACHMENT" | "CASCADING_SELECT" | "FORMULA" | "DEPENDENT" | Yes | |
config | object | No | Kind-specific config object. |
validation | object | No | Optional typed validation rules. |
List field definitions
Read onlyatlas_fields_definitions_list
List custom field definitions in a project. Returns id, key, name, kind, configJson, and validation rules.
- Scope
tasks:read- Calls
- Example prompt
- What custom task fields do we have on the Atlas project?
Arguments
| Field | Type | Required | Description |
|---|---|---|---|
projectId | string | Yes | Project id whose fields to list. |
kind | "TEXT" | "PARAGRAPH" | "NUMBER" | "SELECT" | "MULTI_SELECT" | "DATE" | "DATE_RANGE" | "USER" | "USERS" | "URL" | "CHECKBOX" | "ATTACHMENT" | "CASCADING_SELECT" | "FORMULA" | "DEPENDENT" | No | Optional kind filter. |
limit | integer | No |
Update field definitions
Changes dataatlas_fields_definitions_update
Patch an existing custom field. Pass `validation: null` to clear all rules; pass an object to replace them wholesale. `kind` is immutable.
- Scope
tasks:write- Calls
- Example prompt
- Loosen the Severity field on Atlas - allow values up to 10.
Arguments
| Field | Type | Required | Description |
|---|---|---|---|
projectId | string | Yes | |
id | string | Yes | FieldDefinition id. |
name | string | No | |
description | string | null | No | |
config | object | No | |
validation | object | null | No | Pass null to clear all validation rules; pass an object to replace them. |
expectedVersion | integer | No |
Validate field values
Changes dataatlas_fields_values_validate
Dry-run the per-kind typed validator for a single field+value pair without writing. Returns `{ ok, errors }` so a caller can preview inline form errors before a task write. Pass `fieldId` or `key` (exactly one) plus `value`.
- Scope
tasks:read- Calls
- Example prompt
- Will 0.5 work as a Severity value on the Atlas project?
Arguments
| Field | Type | Required | Description |
|---|---|---|---|
projectId | string | Yes | |
fieldId | string | No | FieldDefinition id (mutually exclusive with key). |
key | string | No | FieldDefinition key (mutually exclusive with fieldId). |
value | any | No | Candidate value to validate. |