Skip to main content
List domains to get a domain_slug before creating a workspace. SDK: client.domains.

​
Generate a draft from a taxonomy file

Upload and parse any supported file type, then pass the succeeded Parse job to domain generation. Generation reads complete parsed content, including sidecars for bounded inline previews, compacts spreadsheet markup to plain text, and makes one model call; the compacted taxonomy input is capped at 100,000 characters. It does not create or update a domain.
POST /v1/domains/generate
When a workbook contains multiple worksheets, include sheet_name to choose the one taxonomy to extract. The service rejects an ambiguous multi-sheet request instead of merging or truncating taxonomies. The response is an unsaved taxonomy draft. Review it, then send the edited values to POST /v1/domains. The alternative description input remains available for text-based generation; provide exactly one of description or source.

​
Suggest a description from a name

POST /v1/domains/suggest-description returns a classifier-facing brief for a domain display name. The console uses it to prefill the Generate tab. An unrecognized name returns an empty description so the author can type their own. Nothing is persisted.
POST /v1/domains/suggest-description
A taxonomy item contains group, subgroup, description, and optional aliases. Publishing rejects an empty, duplicate, reserved, or oversized taxonomy.

​
Retention

A domain you create, in draft or published, is kept until your organization is deleted. There is no delete endpoint: workspaces pin a published version to explain their categories, so move a workspace to a newer version instead. Ask your NDI contact to remove a domain sooner. Generating a draft or suggesting a description saves nothing. See Saved schemas and domains.