.. _auto_ontology_create:

*CREATE ONTOLOGY*
=================

Creates a new ontology record owned by the active user, or updates an existing one, persisting name, description, tags, data payload, graph structure, and runtime options. Supply `ontology_id` to trigger an update of an existing record; omit it to create a new one (in which case `name` is required).

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

Tagged: ``create``, ``graph``, ``ontology``, ``platform``, ``rdf``, ``update``, ``upsert``.

Inputs
------

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

   * - Label
     - ID
     - Type
     - Default
     - Required
     - Description
   * - Ontology
     - ontology_id
     - remote_lookup
     - —
     - 
     - Integer ID of an existing ontology record to update; leave blank to create a new ontology.
   * - Ontology Name
     - name
     - text
     - —
     - ✓
     - Human-readable name for the ontology (e.g. 'CrashDomain v2'); required when creating a new record, optional when updating.
   * - Description
     - description
     - textarea
     - —
     - 
     - Free-text description of the ontology's purpose and scope; optional but recommended for discoverability.
   * - Tags
     - tags
     - text
     - —
     - 
     - Comma-separated string or JSON array of keyword tags used to categorise and search the ontology (e.g. 'crash,material,v2').
   * - Data
     - data
     - dataset
     - —
     - 
     - Arbitrary dataset payload to store with the ontology, such as lookup tables or structured concept definitions; leave blank if not needed.
   * - Graph
     - graph
     - dataset
     - —
     - 
     - Dataset representing the ontology graph as nodes and edges (e.g. RDF triples or adjacency records); leave blank if no graph structure is required.
   * - Options
     - options
     - dataset
     - —
     - 
     - Dataset of rendering or runtime configuration options for the ontology viewer/engine; leave blank to accept platform defaults.
   * - Project
     - project_id
     - remote_lookup
     - —
     - 
     - ID of the d3VIEW project to associate this ontology with; leave blank to create the ontology without a project association.

Outputs
-------

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

   * - Label
     - ID
     - Type
     - Description
   * - Ontology ID
     - ontology_id
     - integer
     - Integer primary key of the created or updated ontology record; use this ID to reference the ontology in downstream workers.
   * - Status
     - status
     - string
     - Human-readable confirmation string indicating the operation performed, e.g. 'Created ontology 42' or 'Updated ontology 42'.

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_create</code>. Schema hash: <code>5fd2e033c373</code>. Hand-curated docs in <code>workerexamples/</code> override this page when present.
   </p>