Primitive
atom.setNestedDataField
BETAShort name: setNestedDataField
Version: 1.0.0
Sets a nested FieldEntry under atom.data using a string[] path. Missing intermediate object entries are created automatically.
Back to primitive libraryInputs
| Key | Type | Required | Description |
|---|---|---|---|
| atomId | objectId | true | Atom to mutate. |
| path | array | true | Nested data path as string[] (for example ["profile", "name", "first"]). Dotted strings are not supported. |
| value | any | true | Value to store at the leaf 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 |
|---|---|---|---|
| action | string | false | "appended" when creating a new leaf or "updated" when replacing an existing leaf. |
| atom | object | false | Updated atom summary: { id, version, lexemeIds, data, isPublic }. |
| path | array | false | Normalized path that was written. |
| previousValue | any | false | Prior leaf value when action is updated; omitted for appended. |