> ## Documentation Index > Fetch the complete documentation index at: https://docs.ndi.nace.ai/llms.txt > Use this file to discover all available pages before exploring further. # 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. ## OpenAPI ````yaml /openapi.json post /v1/domains/suggest-description openapi: 3.1.0 info: description: >- Document intelligence: parse, split, classify, extract, and ground files, or build a searchable workspace. Authenticate with ``X-API-Key``. title: NDI Platform API version: 0.1.0 servers: - url: https://ndi-api.nace.ai security: [] tags: [] paths: /v1/domains/suggest-description: post: tags: - domains summary: suggest_domain_description 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. operationId: suggest_domain_description_v1_domains_suggest_description_post requestBody: content: application/json: schema: $ref: '#/components/schemas/SuggestDomainDescriptionRequest' required: true responses: '200': content: application/json: schema: $ref: '#/components/schemas/SuggestDomainDescriptionResponse' description: Successful Response '504': content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' description: Gateway Timeout default: content: application/json: example: error: code: invalid_request detail: null message: >- Request body has extra fields that this operation does not accept. request_id: req-01j9k2n3p4q5r6s7t8v9 retryable: false schema: $ref: '#/components/schemas/ErrorEnvelope' description: >- Typed error envelope used by every 4xx and 5xx. ``error.code`` distinguishes the failure; HTTP status is a consequence of the code. security: - APIKeyHeader: [] components: schemas: SuggestDomainDescriptionRequest: additionalProperties: false description: Ask the model for a classifier-facing description of a named domain. properties: display_name: description: >- The domain's display name. Meaningless names should yield an empty description. maxLength: 200 minLength: 1 title: Display Name type: string required: - display_name title: SuggestDomainDescriptionRequest type: object SuggestDomainDescriptionResponse: additionalProperties: false description: >- Classifier-facing brief for taxonomy generation, or empty when the name is unusable. properties: description: description: >- Suggested domain description for taxonomy generation. Empty when the name is not a recognizable subject. maxLength: 4000 title: Description type: string required: - description title: SuggestDomainDescriptionResponse type: object ErrorEnvelope: description: Every non-2xx body on ``/v1``. example: error: code: invalid_request detail: null message: Request body has extra fields that this operation does not accept. request_id: req-01j9k2n3p4q5r6s7t8v9 retryable: false properties: error: $ref: '#/components/schemas/Error' required: - error title: ErrorEnvelope type: object Error: description: The error object, per spec 12 §1.8. properties: code: $ref: '#/components/schemas/ErrorCode' detail: anyOf: - additionalProperties: true type: object - type: 'null' description: Structured payload, when the code carries one. title: Detail message: description: Human- and model-readable; says what to do differently. title: Message type: string request_id: anyOf: - type: string - type: 'null' description: >- Per-request correlation id; matches the ``X-Request-Id`` header. Null only when the error was minted outside any HTTP request, e.g. by a worker. title: Request Id retryable: description: Whether retrying the identical request could succeed. title: Retryable type: boolean required: - code - message - retryable title: Error type: object ErrorCode: description: |- Every error the ``/v1`` surface can return. Clients must treat this as an **open** enum: a new member is an additive change (spec 12 §9), and a client that crashes on an unknown code makes every future error a breaking change. enum: - invalid_request - unsupported_file_type - file_too_large - invalid_schema - invalid_sql - invalid_path_prefix - command_not_permitted - batch_too_large - domain_validation_failed - default_label_required - wait_required_for_zero_retention - ledger_decision_invalid - workspace_not_found - file_not_found - job_not_found - upload_not_found - node_not_found - schema_not_found - domain_not_found - session_not_found - access_label_not_found - ledger_understanding_not_found - ledger_table_not_found - path_conflict - schema_version_conflict - access_label_name_taken - workspace_name_taken - access_label_in_use - upload_expired - file_not_ingested - workspace_deleting - workspace_not_deletable - ingestion_in_progress - job_not_cancellable - confirmation_required - domain_not_published - domain_in_use - reserved_domain_slug - kg_not_built - kg_build_in_progress - ledger_understanding_in_progress - session_busy - range_not_satisfiable - result_expired - access_denied - access_backstop_violation - access_mode_not_implemented - rate_limited - concurrency_limit_reached - quota_exceeded - corrupt_file - zero_byte_file - encrypted_file - csv_dialect_ambiguous - csv_parse_failed - parse_failed - ocr_failed - conversion_failed - sheetless_workbook - unplayable_media - unclassified_pages - job_cancelled - job_timeout - upstream_unavailable - internal_error - unauthorized - not_implemented title: ErrorCode type: string securitySchemes: APIKeyHeader: in: header name: X-API-Key type: apiKey ````