Overwrite the current draft ontology with a user-edited one
Replace the current draft with a user-edited ontology, staying in (or returning to) DRAFT.
Immediately overrides the ontology GraphService uses for this project (approved_ontology
is set alongside ontology), so it goes through the same FalkorDB compatibility check as
approve: a retyped already-registered property fails with a 409 and nothing is persisted;
additive changes are force-applied into FalkorDB first. Without that, every later graph
session's OntologyStore.register() would reject the new approved_ontology and break
ingestion/search for the whole project.
Sanitized via sanitize_ontology before either field is written, same as a fresh discovery
draft — an instance-value-shaped attribute name (e.g. carried over from a pre-fix draft, or
pasted in by hand) never gets persisted, let alone made live.
Allowed only from DRAFT/FAILED — DISCOVERING would race a background discovery task, and
APPROVED must go through a fresh propose first (edits after approval reuse the same
compatibility check approve runs, not this endpoint).
AuthorizationBearer <token>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
application/json- body
Request to overwrite the current draft ontology with a user-edited one.
ontology*Successful Response
application/json- response
API-facing view of a project's ontology-discovery/approval state.
id*stringproject_id*stringstate*OntologyStateLifecycle state of a project's discovered ontology.
"discovering""draft""approved""failed""cancelled"ontology?|nullapproved_ontology?|nullsource_file_ids?array<string>boundaries?string|nullpreset?|Starting ontology the current ontology was seeded from (the preset of the last successful discovery before the first save/approve); null until such a discovery succeeds, and for ontologies approved before presets existed.
last_error?string|nullwarnings?array<string>Discovery steps that soft-failed while producing the draft.
created_at*stringdate-timeupdated_at*stringdate-timecurl -X PUT 'https://deepfellow-server-host/v1/graph/ontology/draft' \ -H 'Content-Type: application/json' \ -d '{ "ontology": {}}'{ "id": "string", "project_id": "string", "state": "discovering", "ontology": {}, "approved_ontology": {}, "source_file_ids": [ "string" ], "boundaries": "string", "preset": "general", "last_error": "string", "warnings": [ "string" ], "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.