Preview what applying an ontology change would touch
Count the chunks a change would re-scan (one LLM call each) and the nodes/edges it would change, without changing them.
AuthorizationBearer <token>change_id*stringA 24-character hexadecimal MongoDB ObjectId string.
^[0-9a-fA-F]{24}$OpenAI-Organization?|Organization Id from OpenAi compatible endpoint. Required to organization access or project access (with OpenAI-Project header) when logged as User or Admin User.
OpenAI-Project?|Project Id from OpenAi compatible endpoint. Required to project access for organization api key or User / Admin User access with OpenAI-Organization
Successful Response
application/json- response
API-facing view of one ontology change.
id*stringproject_id*stringop*OntologyChangeOpOne kind of ontology change; each maps to one executor in graph_ontology_evolution.
"add_entity""add_relation_pattern""add_attribute""set_description""rename_entity""rename_relation""rename_attribute""drop_entity""drop_relation""drop_relation_pattern""drop_attribute"payload*||||||||||risk*OntologyChangeRiskWhat applying a change does to existing graph data; destructive changes need explicit confirmation to apply.
"migrating""additive""destructive"origin*OntologyChangeOriginWhat produced an ontology change. drift is reserved for drift-triggered proposals.
"discovery""user""restore""drift"backfill*BackfillScopeWhether applying a change re-scans already-ingested chunks with the LLM (all) or only affects future ingests (none).
"none""all"status*OntologyChangeStatusReview/apply lifecycle of one ontology change.
"proposed""accepted""rejected""applying""applied""failed"inverse_of?string|nulldata_not_restored?booleanfalsedry_run?|nullresult?|nullerror?string|nullapplied_version?integer|nullcreated_at*stringdate-timeupdated_at*stringdate-timecurl -X POST 'https://deepfellow-server-host/v1/graph/ontology/changes/5eb7cf5a86d9755df3a6c593/dry-run'{ "id": "string", "project_id": "string", "op": "add_entity", "payload": { "op": "add_entity", "label": "string", "description": "string", "properties": [ { "name": "string", "type": "STRING", "description": "string" } ] }, "risk": "migrating", "origin": "discovery", "backfill": "none", "status": "proposed", "inverse_of": "string", "data_not_restored": false, "dry_run": { "chunks_in_scope": 0, "affected_nodes": 0, "affected_edges": 0 }, "result": { "llm_calls": 0, "failed_chunks": [ "string" ], "nodes_updated": 0, "edges_updated": 0 }, "error": "string", "applied_version": 0, "created_at": "2019-08-24T14:15:22Z", "updated_at": "2019-08-24T14:15:22Z"}We use cookies on our website. We use them to ensure proper functioning of the site and, if you agree, for purposes such as analytics, marketing, and targeting ads.