Skip to main content
POST
create_domain

Authorizations

X-API-Key
string
header
required

Body

application/json

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

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.

Response

Successful Response

domain
Domain · object
required

A domain with its effective taxonomy already resolved.

A caller reading a domain wants the taxonomy 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.