---
title: "Top-down import (create/replace draft, optionally publish)"
method: POST
path: "/v1/customer-ontologies/import"
tags: ["Customer Ontologies"]
---

# Top-down import (create/replace draft, optionally publish)

`POST /v1/customer-ontologies/import`

## Request

- Base URL: `https://api.talonic.com`
- URL: `https://api.talonic.com/v1/customer-ontologies/import`
- Auth: HTTP bearer

Publishing projects authored fields/doctypes into the field registry and classification — it changes how capture and classification behave for the tenant. Requires the `write` scope.

## Request body

- OntologyImport
  - `name` string, required
  - `description` string
  - `doctypes` OntologyDoctype[]
    - `key` string, required
    - `name` string, required
    - `category` string
    - `maps_to` string: A Talonic ontology_type_id the doctype anchors to.
    - `description` string
    - `signals` string[]
  - `fields` OntologyField[]
    - `key` string, required
    - `canonical_name` string
    - `display_name` string
    - `data_type` string
    - `description` string
    - `synonyms` string[]
    - `doctype_scope` string: Custom doctype key, or null/empty/* for global.
    - `required` boolean
    - `format` string
    - `enum_values` string[]
    - `examples` string[]
  - `publish` boolean: Publish immediately after import.

## Response `200`

Ontology header

---

[API](https://skmtc.dev/talonic/apis/talonic-api.md) · [All operations](https://skmtc.dev/talonic/apis/talonic-api/llms.txt) · [OpenAPI document](https://skmtc.dev/talonic/apis/talonic-api/revisions/678fe5f8c9c3?raw)