Skip to main content
POST
create_domain

Authorizations

X-API-Key
string
header
required

Body

application/json

Creates a draft at version 1 in the caller's tenant.

Most domains should omit ontology entirely — the graph shape is far less corpus-specific than the taxonomy, and defaulting to the platform's generic ontology keeps rule R0 satisfiable by construction.

display_name
string
required
Required string length: 1 - 200
slug
string
required
Maximum string length: 64
Pattern: ^[a-z0-9]+(?:_[a-z0-9]+)*$
taxonomy
Taxonomy · object
required

The classification vocabulary.

ontology
Ontology · object | null

Omitted copies the platform's generic ontology, so plain taxonomies publish without graph work.

Response

Successful Response

domain
Domain · object
required

A domain with inheritance already resolved.

A caller reading a domain wants the vocabulary that will actually be applied, not a delta they have to merge themselves.

validation
DomainValidation · object
required

Returned on every domain write, so a caller never has to guess whether a publish will succeed.