---
title: "suggest_domain_description"
method: POST
path: "/v1/domains/suggest-description"
tags: ["domains"]
---

# suggest_domain_description

`POST /v1/domains/suggest-description`

## Request

- Base URL: `https://ndi-api.nace.ai`
- URL: `https://ndi-api.nace.ai/v1/domains/suggest-description`
- Auth: API key in header `X-API-Key`
- TypeScript: <https://skmtc.dev/nace/apis/ndi-platform-api/docs/v1/domains/suggest-description/post.ts> (a function with typed inputs; its response is checked against the schema)

Draft a classifier-facing description from a domain name. Cost class: slow.

Synchronous and **non-persisting**. The console uses this to prefill the
Generate tab. An unrecognized name returns an empty description rather than
an error so the author can type their own. Kept off MCP because authoring
is a reviewed human act, not an agent-loop step.

## Request body

- SuggestDomainDescriptionRequest: Ask the model for a classifier-facing description of a named domain.
  - `display_name` string, required: The domain's display name. Meaningless names should yield an empty description.

## Response `200`

Successful Response

- SuggestDomainDescriptionResponse: Classifier-facing brief for taxonomy generation, or empty when the name is unusable.
  - `description` string, required: Suggested domain description for taxonomy generation. Empty when the name is not a recognizable subject.

## Other responses

- `504`: Gateway Timeout
- `default`: Typed error envelope used by every 4xx and 5xx. ``error.code`` distinguishes the failure; HTTP status is a consequence of the code.

---

[API](https://skmtc.dev/nace/apis/ndi-platform-api.md) - [All operations](https://skmtc.dev/nace/apis/ndi-platform-api/llms.txt) - [OpenAPI document](https://skmtc.dev/nace/apis/ndi-platform-api/revisions/d002a3589a67?raw)