Ontology

Manages ontology entity and relationship types and instance data.

📄️ List Ontology Models

List Ontology Models, optionally scoped to a collection.

📄️ Create Ontology Model

Create an ontology model in a collection so entity types and relation types can be grouped under it.

📄️ Get Ontology Model

Return one ontology model with its metadata after read permission is checked.

📄️ Update Ontology Model

Change mutable ontology-model metadata after write permission is checked. Identity and collection scope cannot be changed.

📄️ Delete Ontology Model

Permanently remove an ontology model after delete permission is checked. Delete the types it groups before removing the model.

📄️ Preview Ontology Bulk Delete

List the ontology resources affected by bulk deletion of the specified collection.

📄️ Get Ontology Bulk Delete Status

Return the current bulk-delete status for the specified collection.

📄️ Trigger Ontology Bulk Delete

Start bulk deletion of ontology resources in the specified collection.

📄️ Preview Ontology Model Bulk Delete

List the entity types and relation types a bulk delete would remove, together with the resources blocking removal. Nothing is deleted by this operation.

📄️ Get Ontology Model Bulk Delete Status

Return the progress of the most recent bulk-delete run for an ontology model, including per-item state and any failure detail.

📄️ Trigger Ontology Model Bulk Delete

Start an asynchronous bulk delete of the types grouped under an ontology model. Use `target_ids` to limit the run, and poll the bulk-delete status operation for progress.

📄️ List Entities

List all entity types.

📄️ Create Entity

Create an entity type. Its data table is prepared immediately only when a schema is supplied; schema-less entity types defer table preparation until data is available.

📄️ Get Entity Table

Fetch rows from an entity type's table.

📄️ Download Entity Table

Download an entity type's current authoritative rows. Preview results may lag behind recent uploads.

📄️ Upload To Entity Table

Upload CSV, JSON, or Parquet rows to an entity type's table. Each row must include the required structural fields; downstream query and graph surfaces update asynchronously.

📄️ Preview Entity Table Reset

Preview row impact for an EntityType table logical reset.

📄️ Reset Entity Table

Delete all rows from an entity type's table after validating dependencies.

📄️ Get Entity Versions

List version history for an entity type.

📄️ Get Entity

Retrieve a specific entity type.

📄️ Update Entity

Change mutable entity-type metadata or schema after write permission is checked. Fields omitted from the request keep their current values.

📄️ Delete Entity

Delete an entity type. Related data cleanup runs asynchronously.

📄️ Get Entity Cleanup Status

Retrieve the cleanup progress status after entity type deletion.

📄️ List Relations

List all relation types.

📄️ Create Relation

Create a relation type. Its data table is prepared immediately only when both endpoint entity types exist and declare schemas; otherwise preparation is deferred.

📄️ Get Relation Table

Fetch rows from a relation type's table.

📄️ Download Relation Table

Download a relation type's current authoritative rows. Preview results may lag behind recent uploads.

📄️ Upload To Relation Table

Upload CSV, JSON, or Parquet rows to a relation type's table. Each row must include `id` and the required source and target foreign-key columns; downstream query and graph surfaces update asynchronously.

📄️ Preview Relation Table Reset

Preview row impact for a RelationType table logical reset.

📄️ Reset Relation Table

Delete all rows from a relation type's table.

📄️ Get Relation Versions

List version history for a relation type.

📄️ Get Relation

Retrieve a specific relation type.

📄️ Update Relation

Change mutable relation-type metadata, endpoints, or schema after write permission is checked. Fields omitted from the request keep their current values.

📄️ Delete Relation

Delete a relation type. Related data cleanup runs asynchronously.

📄️ Get Relation Cleanup Status

Retrieve the cleanup progress status after relation type deletion.

📄️ Get Relation Graph Load Status

Initial graph-load progress for this relation. Separate from `/cleanup-status`, which reports *deletion* progress — a relation being populated must not read as a relation being removed.

📄️ Trigger Relation Graph Load

Re-run the initial graph load (retry after a failure).

📄️ Get Ontology Health

Return the current ontology service health and consistency status.

📄️ Trigger Ontology Orphan Cleanup

Start cleanup of ontology data that no longer has a corresponding resource.

📄️ Trigger Ontology Resync

Start ontology resynchronization for the requested resources, or for all resources when none are specified.

📄️ Execute Ontology Request

Run one ontology request: a definition plus exactly one terminal. Read terminals return rows, a page, keys, aggregates, or paths. Write terminals change rows in one transaction and accept the `dry_run` and `return_rows` query parameters.

📄️ Compile Ontology Request

The binding is `binding_for`, the very one `compile_ontology_actions` takes at the save boundary, so this route cannot answer differently from the save it predicts. Every terminal is accepted, `compile` included: a terminal-less `Definition` (a Reaction's `condition.set`) reaches here as `{...definition, "compile": {}}`, and restricting the route to that one terminal would empty `write_targets` and skip the anchor, written-column and terminal-fitness checks that are the reason to ask (D1).