> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dotlet.net/llms.txt
> Use this file to discover all available pages before exploring further.

# Setup DNS For Domain

> Manually trigger DNS setup for a purchased domain.

If DNS setup was not enabled during purchase, use this endpoint to set it up.
Returns status and estimated completion time.



## OpenAPI

````yaml POST /api/v1/registrar/domains/{domain}/setup-dns
openapi: 3.1.0
info:
  title: Dotlet API
  description: >-
    The Dotlet API lets you search, register, and manage domains, configure DNS
    records, and embed domain purchasing flows in your own product.


    All endpoints are authenticated with an API key or bearer token, and all
    request and response bodies are JSON.
  version: 0.1.1
  contact:
    name: Dotlet Support
    url: https://dotlet.net/support
    email: support@dotlet.net
servers:
  - url: https://api.dotlet.net
    description: Production
security: []
tags:
  - name: Domains
    description: Search, price, register, renew, and manage domains.
  - name: Orders
    description: Create and track domain orders separately from immediate purchases.
  - name: DNS
    description: Manage DNS records for domains hosted with Dotlet.
  - name: Hosted Sessions
    description: Create embeddable, scoped sessions for end users in your own product.
paths:
  /api/v1/registrar/domains/{domain}/setup-dns:
    post:
      tags:
        - Domains
      summary: Setup Dns For Domain
      description: >-
        Manually trigger DNS setup for a purchased domain.


        If DNS setup was not enabled during purchase, use this endpoint to set
        it up.

        Returns status and estimated completion time.
      operationId: setup_dns_for_domain_api_v1_registrar_domains__domain__setup_dns_post
      parameters:
        - name: domain
          in: path
          required: true
          schema:
            type: string
            title: Domain
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/DNSSetupRequest'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DNSSetupResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
        - APIKeyHeader: []
        - HTTPBearer: []
components:
  schemas:
    DNSSetupRequest:
      properties:
        dns_provider:
          type: string
          maxLength: 50
          minLength: 1
          title: Dns Provider
          default: cloudflare
      type: object
      title: DNSSetupRequest
      description: Request to setup DNS for a purchased domain
    DNSSetupResponse:
      properties:
        message:
          type: string
          title: Message
        status:
          type: string
          title: Status
        zone_id:
          anyOf:
            - type: string
            - type: 'null'
          title: Zone Id
        nameservers:
          items:
            type: string
          type: array
          title: Nameservers
          default: []
        provider:
          anyOf:
            - type: string
            - type: 'null'
          title: Provider
        started_at:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: Started At
        updated_at:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: Updated At
        completed_at:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: Completed At
        progress:
          anyOf:
            - $ref: '#/components/schemas/DNSSetupProgressResponse'
            - type: 'null'
        dns_api_ready:
          anyOf:
            - type: boolean
            - type: 'null'
          title: Dns Api Ready
        error:
          anyOf:
            - type: string
            - type: 'null'
          title: Error
        estimated_completion:
          anyOf:
            - type: string
            - type: 'null'
          title: Estimated Completion
        status_url:
          anyOf:
            - type: string
            - type: 'null'
          title: Status Url
        dns_endpoints:
          anyOf:
            - additionalProperties: true
              type: object
            - type: 'null'
          title: Dns Endpoints
      type: object
      required:
        - message
        - status
      title: DNSSetupResponse
      description: Response from DNS setup request
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    DNSSetupProgressResponse:
      properties:
        zone_created:
          type: boolean
          title: Zone Created
          default: false
        ns_updated_at_registrar:
          type: boolean
          title: Ns Updated At Registrar
          default: false
        ns_delegation_verified:
          type: boolean
          title: Ns Delegation Verified
          default: false
      type: object
      title: DNSSetupProgressResponse
      description: DNS setup progress details
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
      type: object
      required:
        - loc
        - msg
        - type
      title: ValidationError
  securitySchemes:
    APIKeyHeader:
      type: apiKey
      in: header
      name: X-API-Key
    HTTPBearer:
      type: http
      scheme: bearer

````