Skip to main content

Import an Ontology

Top-down import of a complete ontology — doctypes and fields in one call, optionally published immediately. Blank doctype anchors are auto-mapped to Talonic types.

Import is the fast path for standing up an ontology from a definition you already have. You post the whole thing — name, doctypes, and fields — in one call, and optionally publish it immediately with publish: true. Any doctype you leave without a maps_to anchor is auto-mapped to the best-matching Talonic type by embedding similarity before it is saved, so you do not have to hand-anchor every doctype.

Each doctype carries a key, a name, an optional category, classification signals, and the maps_to Talonic anchor. Each field carries a key plus optional canonical_name, display_name, data_type, synonyms, a doctype_scope (a doctype key, or null/empty/* for a global field), required, format, enum_values, and examples.

Auto-mapping is advisory and never overwrites a maps_to you supplied. A doctype whose top match is ambiguous is left blank for you to resolve with the suggest-mappings endpoint.
POST/v1/customer-ontologies/import