Primitive
atom.updateDataField
BETAShort name: updateDataField
Version: 1.0.0
System primitive that overwrites an existing FieldEntry on an atom data map.
Back to primitive libraryInputs
| Key | Type | Required | Description |
|---|---|---|---|
| atomId | objectId | true | Atom whose existing data field should be updated. |
| expectedVersion | integer | false | Optional optimistic concurrency guard. When provided, the atom version must match before writing. |
| fieldName | string | true | Existing data key to overwrite. |
| isPublic | boolean | false | Optional field-level visibility override. |
| lexemeAliases | object | false | Optional lexemeId → label mapping to store on the field. |
| value | any | true | New value for the existing FieldEntry. |
| valueType | string | false | Optional AtomFieldInputType metadata. One of: string, number, integer, boolean, date, instant, linkedAtom, linkedAtomArray, array, object, markdown, url. |
Outputs
| Key | Type | Required | Description |
|---|---|---|---|
| atom | object | false | Updated atom summary: { id, version, lexemeIds, data, isPublic }. |
| fieldName | string | false | The field key that was updated. |
| previousValue | any | false | The field value before this update was applied. |