suggest_domain_description
curl --request POST \
--url https://ndi-api.nace.ai/v1/domains/suggest-description \
--header 'Content-Type: application/json' \
--header 'X-API-Key: <api-key>' \
--data '
{
"display_name": "<string>"
}
'{
"description": "<string>"
}{
"error": {
"code": "invalid_request",
"detail": null,
"message": "Request body has extra fields that this operation does not accept.",
"request_id": "req-01j9k2n3p4q5r6s7t8v9",
"retryable": false
}
}{
"error": {
"code": "invalid_request",
"detail": null,
"message": "Request body has extra fields that this operation does not accept.",
"request_id": "req-01j9k2n3p4q5r6s7t8v9",
"retryable": false
}
}suggest_domain_description
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.
POST
/
v1
/
domains
/
suggest-description
suggest_domain_description
curl --request POST \
--url https://ndi-api.nace.ai/v1/domains/suggest-description \
--header 'Content-Type: application/json' \
--header 'X-API-Key: <api-key>' \
--data '
{
"display_name": "<string>"
}
'{
"description": "<string>"
}{
"error": {
"code": "invalid_request",
"detail": null,
"message": "Request body has extra fields that this operation does not accept.",
"request_id": "req-01j9k2n3p4q5r6s7t8v9",
"retryable": false
}
}{
"error": {
"code": "invalid_request",
"detail": null,
"message": "Request body has extra fields that this operation does not accept.",
"request_id": "req-01j9k2n3p4q5r6s7t8v9",
"retryable": false
}
}Authorizations
Body
application/json
Ask the model for a classifier-facing description of a named domain.
The domain's display name. Meaningless names should yield an empty description.
Required string length:
1 - 200Response
Successful Response
Classifier-facing brief for taxonomy generation, or empty when the name is unusable.
Suggested domain description for taxonomy generation. Empty when the name is not a recognizable subject.
Maximum string length:
4000