AIFeatures
> Auto-generated from the OpenAPI spec. Method names shown are the manifest > (canonical) names; per-language casing is applied by each SDK.
Record handle: ref(id) → a lazy handle to one ColumnDataTransform (get/update/delete, field values, related records). See record handles.
createAiColumnDataTransform
POST /ai/column-data-transform/{entityId}
Create a column data transform config
| Parameter | In | Required | Description |
|---|---|---|---|
entityId |
path | yes | |
body |
body | yes |
Returns: ColumnDataTransform · Cost: 1 API call.
createAiColumnDataValidationResult
POST /ai/column-data-validation-result
Create a column data validation result
| Parameter | In | Required | Description |
|---|---|---|---|
body |
body | yes |
Returns: ColumnDataValidationResult · Cost: 1 API call.
createColumnDataValidation
POST /ai/column-data-validation
Create a column data validation config
| Parameter | In | Required | Description |
|---|---|---|---|
body |
body | yes |
Returns: ColumnDataValidation · Cost: 1 API call.
createValidateCalculationFunction
POST /validate-calculation-function
Validate a field calculation formula — Validates a field calculation formula against the supplied parameters. Returns a success flag and an error message if validation fails.
| Parameter | In | Required | Description |
|---|---|---|---|
body |
body | yes |
Returns: void · Cost: 1 API call.
deleteAiColumnDataTransform
DELETE /ai/column-data-transform/{entityId}
Delete a column data transform config
| Parameter | In | Required | Description |
|---|---|---|---|
entityId |
path | yes | ID of Ai column data transform config |
Returns: any · Cost: 1 API call.
deleteAiColumnDataValidation
DELETE /ai/column-data-validation/{entityId}
Delete a column data validation config
| Parameter | In | Required | Description |
|---|---|---|---|
entityId |
path | yes | ID of Ai column data validation config |
Returns: any · Cost: 1 API call.
deleteAiColumnDataValidationResult
DELETE /ai/column-data-validation-result/{entityId}
Delete a column data validation result
| Parameter | In | Required | Description |
|---|---|---|---|
entityId |
path | yes | ID of Ai column data validation result config |
Returns: any · Cost: 1 API call.
executeAiColumnDataValidation
POST /ai/column-data-validation/{entityId}/execute
Execute a column data validation on demand
| Parameter | In | Required | Description |
|---|---|---|---|
entityId |
path | yes | ID of Ai column data validation config |
body |
body | yes |
Returns: void · Cost: 1 API call.
executeColumnDataTransform
POST /column-data-transform/{entityId}/execute
Execute a column data transform on demand — Applies a saved column data transform rule to a batch of record IDs, rewriting each record's custom field value according to the configured AI prompt. Requires sufficient AI token balance.
| Parameter | In | Required | Description |
|---|---|---|---|
entityId |
path | yes | ID of Ai column data validation config |
body |
body | yes |
Returns: void · Cost: 1 API call.
generateCustomField
POST /ai/generate-custom-field
Generate a value for a custom field using AI — Generates a value for a custom field using AI based on the provided prompt and module context. Requires sufficient AI token balance.
| Parameter | In | Required | Description |
|---|---|---|---|
body |
body | yes |
Returns: any · Cost: 1 API call.
generateModules
POST /ai/generate-custom-modules
Generate module definitions using AI — Generates module definitions using AI from a single prompt. Requires sufficient AI token balance.
| Parameter | In | Required | Description |
|---|---|---|---|
body |
body | yes |
Returns: any · Cost: 1 API call.
getAiColumnDataTransform
GET /ai/column-data-transform/{entityId}
Get a column data transform config
| Parameter | In | Required | Description |
|---|---|---|---|
entityId |
path | yes | ID of Ai column data transform config |
Returns: ColumnDataTransform · Cost: 1 API call.
getAiColumnDataValidation
GET /ai/column-data-validation/{entityId}
Get a column data validation config
| Parameter | In | Required | Description |
|---|---|---|---|
entityId |
path | yes | ID of Ai column data validation config |
Returns: ColumnDataValidation · Cost: 1 API call.
getAiColumnDataValidationResult
GET /ai/column-data-validation-result/{entityId}
Get a column data validation result
| Parameter | In | Required | Description |
|---|---|---|---|
entityId |
path | yes | ID of Ai column data validation result config |
Returns: ColumnDataValidationResult · Cost: 1 API call.
getFieldGenerate
GET /field/generate/{fieldId}
Generate a value for a field using AI — Uses AI to generate values for one or more fields on a given entity. entityId may be a single ID or a JSON-encoded array. Requires edit permissions on the entity and sufficient AI token balance.
| Parameter | In | Required | Description |
|---|---|---|---|
fieldId |
path | yes | A JSON-encoded list of IDs or a single field ID. |
entityModule |
query | yes | Module of field value |
entityId |
query | yes | Id of field value |
Returns: void · Cost: 1 API call.
listAiColumnDataTransform
GET /ai/column-data-transform
List column data transform configs
| Parameter | In | Required | Description |
|---|---|---|---|
filter |
query | no | Filter expression to narrow results. Format: field operator value. Multiple conditions are joined with ; or & (AND) or | (OR). Conditions can be grouped with parentheses. Supported operators: = (equals; also matches NULL when value is empty), != (not equals), >, >=, <, <=, ~ (LIKE, use % as wildcard; empty value matches NULL/empty), !~ (NOT LIKE), ... (IN set, comma-separated: statusId...1,2,3). OR across values for one field: status=(active|pending). Examples: filter=name=Acme, filter=created>=2024-01-01;assigneeId=, filter=name~%smith%;statusId...1,2,3, filter=(status=active|status=pending)&spaceId=5. |
offset |
query | no | Zero-based index of the first record to return. Use together with limit for pagination. Example: offset=20&limit=10 returns records 21–30. |
limit |
query | no | Maximum number of records to return. Use together with offset for pagination. |
order |
query | no | Sort order for results. Comma-separated list of field;DIRECTION pairs. Direction is ASC or DESC (default DESC when omitted). Example: order=name;ASC or order=id;ASC,name;DESC. |
Returns: list<ColumnDataTransform> · Cost: 1 API call per page (lazy paginator).
listAiColumnDataValidation
GET /ai/column-data-validation
List column data validation configs
| Parameter | In | Required | Description |
|---|---|---|---|
filter |
query | no | Filter expression to narrow results. Format: field operator value. Multiple conditions are joined with ; or & (AND) or | (OR). Conditions can be grouped with parentheses. Supported operators: = (equals; also matches NULL when value is empty), != (not equals), >, >=, <, <=, ~ (LIKE, use % as wildcard; empty value matches NULL/empty), !~ (NOT LIKE), ... (IN set, comma-separated: statusId...1,2,3). OR across values for one field: status=(active|pending). Examples: filter=name=Acme, filter=created>=2024-01-01;assigneeId=, filter=name~%smith%;statusId...1,2,3, filter=(status=active|status=pending)&spaceId=5. |
offset |
query | no | Zero-based index of the first record to return. Use together with limit for pagination. Example: offset=20&limit=10 returns records 21–30. |
limit |
query | no | Maximum number of records to return. Use together with offset for pagination. |
order |
query | no | Sort order for results. Comma-separated list of field;DIRECTION pairs. Direction is ASC or DESC (default DESC when omitted). Example: order=name;ASC or order=id;ASC,name;DESC. |
Returns: list<ColumnDataValidation> · Cost: 1 API call per page (lazy paginator).
listAiColumnDataValidationResults
GET /ai/column-data-validation-result
List column data validation results
| Parameter | In | Required | Description |
|---|---|---|---|
filter |
query | no | Filter expression to narrow results. Format: field operator value. Multiple conditions are joined with ; or & (AND) or | (OR). Conditions can be grouped with parentheses. Supported operators: = (equals; also matches NULL when value is empty), != (not equals), >, >=, <, <=, ~ (LIKE, use % as wildcard; empty value matches NULL/empty), !~ (NOT LIKE), ... (IN set, comma-separated: statusId...1,2,3). OR across values for one field: status=(active|pending). Examples: filter=name=Acme, filter=created>=2024-01-01;assigneeId=, filter=name~%smith%;statusId...1,2,3, filter=(status=active|status=pending)&spaceId=5. |
offset |
query | no | Zero-based index of the first record to return. Use together with limit for pagination. Example: offset=20&limit=10 returns records 21–30. |
limit |
query | no | Maximum number of records to return. Use together with offset for pagination. |
order |
query | no | Sort order for results. Comma-separated list of field;DIRECTION pairs. Direction is ASC or DESC (default DESC when omitted). Example: order=name;ASC or order=id;ASC,name;DESC. |
Returns: list<ColumnDataValidationResult> · Cost: 1 API call per page (lazy paginator).
previewColumnDataTransform
POST /column-data-transform/{entityId}/preview
Preview a column data transform without saving — Performs a one-time transformation on a single preview object using a custom prompt, without saving any configuration. Useful for testing prompts before creating a transform rule.
| Parameter | In | Required | Description |
|---|---|---|---|
entityId |
path | yes | ID of Ai column data validation config |
body |
body | yes |
Returns: void · Cost: 1 API call.
updateAiColumnDataTransform
PUT /ai/column-data-transform/{entityId}
Update a column data transform config
| Parameter | In | Required | Description |
|---|---|---|---|
entityId |
path | yes | ID of Ai column data transform config |
body |
body | yes |
Returns: ColumnDataTransform · Cost: 1 API call.
updateAiColumnDataValidationResult
PUT /ai/column-data-validation-result/{entityId}
Update a column data validation result
| Parameter | In | Required | Description |
|---|---|---|---|
entityId |
path | yes | ID of Ai column data validation result config |
body |
body | yes |
Returns: ColumnDataValidationResult · Cost: 1 API call.
updateColumnDataValidation
PUT /ai/column-data-validation/{entityId}
Update a column data validation config
| Parameter | In | Required | Description |
|---|---|---|---|
entityId |
path | yes | ID of Ai column data validation config |
body |
body | yes |
Returns: ColumnDataValidation · Cost: 1 API call.