---
title: "Configure Dns Record"
method: POST
path: "/v1/domains/{domain}/dns-record"
---

# Configure Dns Record

`POST /v1/domains/{domain}/dns-record`

## Request

- Base URL: `https://api.aivikings.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.aivikings.ai/v1/domains/{domain}/dns-record`
- Auth: none declared

## Path parameters

- `domain` string, required

## Request body

- ConfigureDnsRecordRequest
  - `record_value` string, required: Target IP address for the A record.
  - `host` string: Relative subdomain name, for example www or staging.api. Use @ for the root/apex record.

## Response `200`

Successful Response

- DomainStatusResponse
  - `domain` string, required
  - `status` string, required
  - `expiry` string, date-time, nullable
  - `nameservers` string[], required
  - `long_domain` boolean, required
  - `period_years` integer, required
  - `contact_handle` string, nullable
  - `registrant_verification_status` string, nullable
  - `registrant_verification_date` string, date-time, nullable
  - `provider_domain_locked` boolean, nullable
  - `provider_code` integer, nullable
  - `provider_description` string, nullable

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/aivikings/apis/aivikings-ai-agent-registrar.md) · [All operations](https://skmtc.dev/aivikings/apis/aivikings-ai-agent-registrar/llms.txt) · [OpenAPI document](https://skmtc.dev/aivikings/apis/aivikings-ai-agent-registrar/revisions/2fc32ee9d1b1?raw)