.. _auto_ontology_update:

*UPDATE ONTOLOGY*
=================

Insert, remove, or update nodes and edges in an existing ARC2-backed RDF ontology store. Use this worker to keep ontologies in sync with external data sources by applying incremental graph mutations without rebuilding from scratch.

When to use
-----------

Tagged: ``arc2``, ``edges``, ``graph``, ``insert``, ``nodes``, ``ontology``, ``rdf``, ``remove``.

Inputs
------

.. list-table::
   :header-rows: 1
   :widths: 20 20 20 20 20 20

   * - Label
     - ID
     - Type
     - Default
     - Required
     - Description
   * - Ontology Store Name
     - ontology_store_name
     - text
     - —
     - ✓
     - Name of the existing ARC2 ontology store to target (the prefix 'arc2_ontology_' is added automatically if omitted); must match a store previously created by the Ontology From JSON worker.
   * - Update Type
     - update_type
     - select
     - —
     - ✓
     - Operation to perform: 'insert' adds new nodes/edges, 'remove' deletes existing ones by id, and 'update' replaces existing nodes in-place with new data.
   * - Update Data (JSON)
     - update_data
     - textarea
     - —
     - ✓
     - JSON object containing 'nodes' and/or 'edges' arrays; for insert/update each node requires id, name, and type fields plus an optional data map, while for remove only the id is needed, and each edge requires from, to, and type fields.

Outputs
-------

.. list-table::
   :header-rows: 1
   :widths: 20 20 20 20

   * - Label
     - ID
     - Type
     - Description
   * - Status
     - status
     - text
     - Outcome of the operation as a string: 'Success' if all mutations were applied, 'Validation Failed' if the input data failed schema checks, or 'Error' if a runtime or connectivity fault occurred.
   * - Nodes Affected
     - nodes_affected
     - number
     - Count of node triples inserted, updated, or removed during the operation; zero when only edge mutations were requested.
   * - Edges Affected
     - edges_affected
     - number
     - Count of edge triples inserted or removed during the operation; zero when only node mutations were requested.
   * - Summary
     - summary
     - text
     - Human-readable one-line description of what was done, e.g. 'Inserted 3 nodes and 2 edges into store sim_ontology'; useful for logging and report generation.
   * - Validation Errors
     - validation_errors
     - text
     - Newline-delimited list of validation error messages raised before or during the mutation (e.g. missing required fields, invalid JSON); empty string when status is 'Success'.

Disciplines
-----------

- platform.ontology

.. raw:: html

   <hr style="margin-top:2em">
   <p style="font-size:11px;color:#888">
   Auto-generated from <code>platform</code> schema. Worker id: <code>ontology_update</code>. Schema hash: <code>d72eecf22819</code>. Hand-curated docs in <code>workerexamples/</code> override this page when present.
   </p>