Primitive
atom.appendDataField
BETAShort name: appendDataField
Version: 1.0.0
System primitive that appends a single FieldEntry to an atom's data map. Fails if the field name already exists (use a separate update primitive to overwrite).
Back to primitive libraryInputs
| Key | Type | Required | Description |
|---|---|---|---|
| atomId | objectId | true | Atom to mutate. Caller must have manage rights (owner, org-member, or admin). |
| fieldName | string | true | Key under data to create. Must not already exist on the atom. |
| isPublic | boolean | false | Field-level visibility. Only the atom owner may set this to false; org-members and admins cannot privatize a field they do not own. |
| lexemeAliases | object | false | Map of lexemeId → display label, allowing this field to surface under different names per subscribed lexeme. |
| value | any | true | Stored value for the new FieldEntry. No type is enforced; valueType is descriptive metadata. |
| valueType | string | false | Declared AtomFieldInputType for the value. 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 name that was appended. |