# Eternity Domains API

## Check availability and prices for multiple domains

> Принимает JSON \`{ "domains": \["example.com"] }\`. Возвращает статус и цену по каждому домену.

```json
{"openapi":"3.0.3","info":{"title":"Eternity Domains API","version":"1.0.0"},"servers":[{"url":"https://api.eternity.domains","description":"Main server"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"InfoRequest":{"type":"object","properties":{"domains":{"type":"array","items":{"type":"string"},"description":"Список доменов для проверки (минимум 1, максимум 100)"}},"required":["domains"]},"InfoResponse":{"type":"object","properties":{"results":{"type":"array","items":{"$ref":"#/components/schemas/InfoResultItem"}},"success":{"type":"boolean"},"total":{"type":"integer","description":"Количество результатов (== length of results)"}}},"InfoResultItem":{"type":"object","properties":{"domain":{"type":"string"},"status":{"type":"string","description":"available | registered | error | unsupported_tld"},"code":{"type":"integer","description":"Код статуса (0 = ok, >0 = ошибка)"},"price":{"type":"number","format":"float","description":"Цена регистрации в USD, если применимо"},"error":{"type":"string","description":"Текст ошибки, если есть"}}},"ErrorResponse":{"type":"object","properties":{"error":{"type":"string","description":"Короткое сообщение об ошибке"},"code":{"type":"integer","description":"Внутренний код ошибки"},"details":{"type":"string","description":"Подробности ошибки — для отладки"}}}}},"paths":{"/api/v1/info":{"post":{"summary":"Check availability and prices for multiple domains","description":"Принимает JSON `{ \"domains\": [\"example.com\"] }`. Возвращает статус и цену по каждому домену.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/InfoRequest"}}}},"responses":{"200":{"description":"Результаты проверки по каждому домену","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InfoResponse"}}}},"400":{"description":"Неверный запрос","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}}}
```

## Get DNS records for a domain

> Требуется тело запроса \`{ "domain": "example.com" }\`. Проверяется Authorization Bearer token. Если домен подключён к Cloudflare — возвращаются CF-записи (включая поле \`proxy\`). Если включён EDNS провайдера — возвращаются записи формата EDNS (включая поле \`priority\` для MX/SRV).

```json
{"openapi":"3.0.3","info":{"title":"Eternity Domains API","version":"1.0.0"},"servers":[{"url":"https://api.eternity.domains","description":"Main server"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"DomainRequest":{"type":"object","properties":{"domain":{"type":"string","description":"Домен в формате example.com"}},"required":["domain"]},"DnsResponse":{"type":"object","properties":{"records":{"type":"array","items":{"anyOf":[{"$ref":"#/components/schemas/DnsRecordCloudflare"},{"$ref":"#/components/schemas/DnsRecordEDNS"}]},"description":"Array of DNS records. Items may be Cloudflare-style (with proxy) or EDNS-style (with priority)."},"code":{"type":"integer"}}},"DnsRecordCloudflare":{"type":"object","properties":{"id":{"type":"string"},"type":{"type":"string"},"name":{"type":"string"},"content":{"type":"string"},"proxy":{"type":"boolean","description":"Cloudflare proxy flag (true/false)"}}},"DnsRecordEDNS":{"type":"object","properties":{"id":{"type":"string"},"type":{"type":"string"},"name":{"type":"string"},"content":{"type":"string"},"priority":{"type":"integer","description":"Priority for MX/SRV records; may be null for others"}}},"ErrorResponse":{"type":"object","properties":{"error":{"type":"string","description":"Короткое сообщение об ошибке"},"code":{"type":"integer","description":"Внутренний код ошибки"},"details":{"type":"string","description":"Подробности ошибки — для отладки"}}}}},"paths":{"/api/v1/dns":{"get":{"summary":"Get DNS records for a domain","description":"Требуется тело запроса `{ \"domain\": \"example.com\" }`. Проверяется Authorization Bearer token. Если домен подключён к Cloudflare — возвращаются CF-записи (включая поле `proxy`). Если включён EDNS провайдера — возвращаются записи формата EDNS (включая поле `priority` для MX/SRV).","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DomainRequest"}}}},"responses":{"200":{"description":"Список DNS записей (Cloudflare или EDNS)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DnsResponse"}}}},"400":{"description":"Bad request — domain missing or invalid","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Unauthorized — API key not found or missing Authorization header","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error while fetching DNS records","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}}}
```

## Add DNS record (Cloudflare or EDNS)

> Добавляет DNS запись. Валидация IP для A/AAAA выполняется на стороне сервера.

```json
{"openapi":"3.0.3","info":{"title":"Eternity Domains API","version":"1.0.0"},"servers":[{"url":"https://api.eternity.domains","description":"Main server"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"AddRecordRequest":{"type":"object","required":["domain","subdomain","content","type"],"properties":{"domain":{"type":"string"},"subdomain":{"type":"string","description":"Имя записи, например 'www' или '@'"},"content":{"type":"string","description":"IP для A/AAAA или значение для CNAME/TXT"},"type":{"type":"string","description":"Тип записи: A, AAAA, CNAME, TXT, MX и т.п."}}},"GenericSuccess":{"type":"object","properties":{"message":{"type":"string","description":"Человеко-читаемое сообщение"},"success":{"type":"boolean","description":"Флаг успеха"},"code":{"type":"integer","description":"Код операции, 0 — ok"}}},"ErrorResponse":{"type":"object","properties":{"error":{"type":"string","description":"Короткое сообщение об ошибке"},"code":{"type":"integer","description":"Внутренний код ошибки"},"details":{"type":"string","description":"Подробности ошибки — для отладки"}}}}},"paths":{"/api/v1/addrecord":{"post":{"summary":"Add DNS record (Cloudflare or EDNS)","description":"Добавляет DNS запись. Валидация IP для A/AAAA выполняется на стороне сервера.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AddRecordRequest"}}}},"responses":{"200":{"description":"Запись добавлена","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GenericSuccess"}}}},"400":{"description":"Ошибка валидации","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}}}
```

## Enable Cloudflare for a domain

> Запускает процесс подключения Cloudflare: создаёт зону и обновляет флаги в БД. Если домен уже зарегистрирован — будет использована текущая регистрационная информация.

```json
{"openapi":"3.0.3","info":{"title":"Eternity Domains API","version":"1.0.0"},"servers":[{"url":"https://api.eternity.domains","description":"Main server"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"DomainRequest":{"type":"object","properties":{"domain":{"type":"string","description":"Домен в формате example.com"}},"required":["domain"]},"GenericSuccess":{"type":"object","properties":{"message":{"type":"string","description":"Человеко-читаемое сообщение"},"success":{"type":"boolean","description":"Флаг успеха"},"code":{"type":"integer","description":"Код операции, 0 — ok"}}},"ErrorResponse":{"type":"object","properties":{"error":{"type":"string","description":"Короткое сообщение об ошибке"},"code":{"type":"integer","description":"Внутренний код ошибки"},"details":{"type":"string","description":"Подробности ошибки — для отладки"}}}}},"paths":{"/api/v1/enablecf":{"put":{"summary":"Enable Cloudflare for a domain","description":"Запускает процесс подключения Cloudflare: создаёт зону и обновляет флаги в БД. Если домен уже зарегистрирован — будет использована текущая регистрационная информация.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DomainRequest"}}}},"responses":{"200":{"description":"Cloudflare queued","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GenericSuccess"}}}},"404":{"description":"Domain not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}}}
```

## Disable Cloudflare for a domain

> Отключает Cloudflare: возвращает неймсерверы регистратора и очищает CF-конфигурацию.

```json
{"openapi":"3.0.3","info":{"title":"Eternity Domains API","version":"1.0.0"},"servers":[{"url":"https://api.eternity.domains","description":"Main server"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"DomainRequest":{"type":"object","properties":{"domain":{"type":"string","description":"Домен в формате example.com"}},"required":["domain"]},"GenericSuccess":{"type":"object","properties":{"message":{"type":"string","description":"Человеко-читаемое сообщение"},"success":{"type":"boolean","description":"Флаг успеха"},"code":{"type":"integer","description":"Код операции, 0 — ok"}}},"ErrorResponse":{"type":"object","properties":{"error":{"type":"string","description":"Короткое сообщение об ошибке"},"code":{"type":"integer","description":"Внутренний код ошибки"},"details":{"type":"string","description":"Подробности ошибки — для отладки"}}}}},"paths":{"/api/v1/disablecf":{"put":{"summary":"Disable Cloudflare for a domain","description":"Отключает Cloudflare: возвращает неймсерверы регистратора и очищает CF-конфигурацию.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DomainRequest"}}}},"responses":{"200":{"description":"Cloudflare disabled","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GenericSuccess"}}}},"404":{"description":"Domain not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}}}
```

## Get domain registry info (expire, status)

> Возвращает состояние домена в реестре. Тело запроса \`{ "domain": "example.com" }\`.

```json
{"openapi":"3.0.3","info":{"title":"Eternity Domains API","version":"1.0.0"},"servers":[{"url":"https://api.eternity.domains","description":"Main server"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"DomainRequest":{"type":"object","properties":{"domain":{"type":"string","description":"Домен в формате example.com"}},"required":["domain"]},"DomainInfoResponse":{"type":"object","properties":{"domain":{"type":"string"},"expire":{"type":"integer","description":"Unix ms — время окончания регистрации"},"status":{"type":"string","description":"ok | pending | error"},"code":{"type":"integer"}}},"ErrorResponse":{"type":"object","properties":{"error":{"type":"string","description":"Короткое сообщение об ошибке"},"code":{"type":"integer","description":"Внутренний код ошибки"},"details":{"type":"string","description":"Подробности ошибки — для отладки"}}}}},"paths":{"/api/v1/domain":{"get":{"summary":"Get domain registry info (expire, status)","description":"Возвращает состояние домена в реестре. Тело запроса `{ \"domain\": \"example.com\" }`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DomainRequest"}}}},"responses":{"200":{"description":"Domain info","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DomainInfoResponse"}}}},"404":{"description":"Domain not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}}}
```

## Register a domain

> Обычная регистрация домена.

```json
{"openapi":"3.0.3","info":{"title":"Eternity Domains API","version":"1.0.0"},"servers":[{"url":"https://api.eternity.domains","description":"Main server"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"DomainRequest":{"type":"object","properties":{"domain":{"type":"string","description":"Домен в формате example.com"}},"required":["domain"]},"GenericSuccess":{"type":"object","properties":{"message":{"type":"string","description":"Человеко-читаемое сообщение"},"success":{"type":"boolean","description":"Флаг успеха"},"code":{"type":"integer","description":"Код операции, 0 — ok"}}},"ErrorResponse":{"type":"object","properties":{"error":{"type":"string","description":"Короткое сообщение об ошибке"},"code":{"type":"integer","description":"Внутренний код ошибки"},"details":{"type":"string","description":"Подробности ошибки — для отладки"}}}}},"paths":{"/api/v1/register":{"post":{"summary":"Register a domain","description":"Обычная регистрация домена.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DomainRequest"}}}},"responses":{"200":{"description":"Registered","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GenericSuccess"}}}},"402":{"description":"Insufficient balance","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"406":{"description":"Domain already registered","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}}}
```

## Register a domain and enable Cloudflare immediately

> Регистрирует и одновременно создаёт Cloudflare-зону; используется, если нужно сразу зарегестрировать домен с Cloudflare.

```json
{"openapi":"3.0.3","info":{"title":"Eternity Domains API","version":"1.0.0"},"servers":[{"url":"https://api.eternity.domains","description":"Main server"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"DomainRequest":{"type":"object","properties":{"domain":{"type":"string","description":"Домен в формате example.com"}},"required":["domain"]},"GenericSuccess":{"type":"object","properties":{"message":{"type":"string","description":"Человеко-читаемое сообщение"},"success":{"type":"boolean","description":"Флаг успеха"},"code":{"type":"integer","description":"Код операции, 0 — ok"}}},"ErrorResponse":{"type":"object","properties":{"error":{"type":"string","description":"Короткое сообщение об ошибке"},"code":{"type":"integer","description":"Внутренний код ошибки"},"details":{"type":"string","description":"Подробности ошибки — для отладки"}}}}},"paths":{"/api/v1/registerwithcf":{"post":{"summary":"Register a domain and enable Cloudflare immediately","description":"Регистрирует и одновременно создаёт Cloudflare-зону; используется, если нужно сразу зарегестрировать домен с Cloudflare.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DomainRequest"}}}},"responses":{"200":{"description":"Registered + CF enabled","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GenericSuccess"}}}},"400":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}}}
```

## Register a domain and set to provider's DNS (EDNS)

> Регистрирует домен и включает EDNS провайдера&#x20;

```json
{"openapi":"3.0.3","info":{"title":"Eternity Domains API","version":"1.0.0"},"servers":[{"url":"https://api.eternity.domains","description":"Main server"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"DomainRequest":{"type":"object","properties":{"domain":{"type":"string","description":"Домен в формате example.com"}},"required":["domain"]},"GenericSuccess":{"type":"object","properties":{"message":{"type":"string","description":"Человеко-читаемое сообщение"},"success":{"type":"boolean","description":"Флаг успеха"},"code":{"type":"integer","description":"Код операции, 0 — ok"}}},"ErrorResponse":{"type":"object","properties":{"error":{"type":"string","description":"Короткое сообщение об ошибке"},"code":{"type":"integer","description":"Внутренний код ошибки"},"details":{"type":"string","description":"Подробности ошибки — для отладки"}}}}},"paths":{"/api/v1/registerwithdns":{"post":{"summary":"Register a domain and set to provider's DNS (EDNS)","description":"Регистрирует домен и включает EDNS провайдера ","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DomainRequest"}}}},"responses":{"200":{"description":"Registered + EDNS enabled","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GenericSuccess"}}}},"400":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}}}
```

## List domains owned by API key

> Возвращает список доменов, связанных с переданным в Authorization ключом API.

```json
{"openapi":"3.0.3","info":{"title":"Eternity Domains API","version":"1.0.0"},"servers":[{"url":"https://api.eternity.domains","description":"Main server"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"DomainsListResponse":{"type":"array","items":{"$ref":"#/components/schemas/DomainsListItem"}},"DomainsListItem":{"type":"object","properties":{"id":{"type":"string"},"domain":{"type":"string"},"cf_enabled":{"type":"boolean","description":"Cloudflare enabled flag"},"creation_time":{"type":"integer","description":"Unix ms — время создания"},"red_trust":{"type":"boolean","description":"Внутренний флаг доверия"}}},"ErrorResponse":{"type":"object","properties":{"error":{"type":"string","description":"Короткое сообщение об ошибке"},"code":{"type":"integer","description":"Внутренний код ошибки"},"details":{"type":"string","description":"Подробности ошибки — для отладки"}}}}},"paths":{"/api/v1/domains":{"get":{"summary":"List domains owned by API key","description":"Возвращает список доменов, связанных с переданным в Authorization ключом API.","responses":{"200":{"description":"Array of domain objects","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DomainsListResponse"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}}}
```

## Get balance&#x20;

> Возвращает баланс в долларах

```json
{"openapi":"3.0.3","info":{"title":"Eternity Domains API","version":"1.0.0"},"servers":[{"url":"https://api.eternity.domains","description":"Main server"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"BalanceResponse":{"type":"object","properties":{"balance":{"type":"number","format":"float","description":"Баланс в USD"}}},"ErrorResponse":{"type":"object","properties":{"error":{"type":"string","description":"Короткое сообщение об ошибке"},"code":{"type":"integer","description":"Внутренний код ошибки"},"details":{"type":"string","description":"Подробности ошибки — для отладки"}}}}},"paths":{"/api/v1/balance":{"get":{"summary":"Get balance ","description":"Возвращает баланс в долларах","responses":{"200":{"description":"Balance","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BalanceResponse"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}}}
```

## Get domain nameservers (from registrar)

> Требуется тело \`{ "domain": "example.com" }\`. Возвращает массив неймсерверов.

```json
{"openapi":"3.0.3","info":{"title":"Eternity Domains API","version":"1.0.0"},"servers":[{"url":"https://api.eternity.domains","description":"Main server"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"DomainRequest":{"type":"object","properties":{"domain":{"type":"string","description":"Домен в формате example.com"}},"required":["domain"]},"NameserversResponse":{"type":"object","properties":{"ns":{"type":"array","items":{"type":"string"}},"code":{"type":"integer"}}}}},"paths":{"/api/v1/nameservers":{"get":{"summary":"Get domain nameservers (from registrar)","description":"Требуется тело `{ \"domain\": \"example.com\" }`. Возвращает массив неймсерверов.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DomainRequest"}}}},"responses":{"200":{"description":"Nameservers","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NameserversResponse"}}}}}}}}}
```

## Patch nameservers for domain

> Обновляет неймсерверы домена. Если домен был подключён к Cloudflare — CF настройки удаляются.

```json
{"openapi":"3.0.3","info":{"title":"Eternity Domains API","version":"1.0.0"},"servers":[{"url":"https://api.eternity.domains","description":"Main server"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"NameserversPatchRequest":{"type":"object","required":["domain","ns0","ns1"],"properties":{"domain":{"type":"string"},"ns0":{"type":"string"},"ns1":{"type":"string"}}},"GenericSuccess":{"type":"object","properties":{"message":{"type":"string","description":"Человеко-читаемое сообщение"},"success":{"type":"boolean","description":"Флаг успеха"},"code":{"type":"integer","description":"Код операции, 0 — ok"}}},"ErrorResponse":{"type":"object","properties":{"error":{"type":"string","description":"Короткое сообщение об ошибке"},"code":{"type":"integer","description":"Внутренний код ошибки"},"details":{"type":"string","description":"Подробности ошибки — для отладки"}}}}},"paths":{"/api/v1/nameservers":{"patch":{"summary":"Patch nameservers for domain","description":"Обновляет неймсерверы домена. Если домен был подключён к Cloudflare — CF настройки удаляются.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NameserversPatchRequest"}}}},"responses":{"200":{"description":"Nameservers updated","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GenericSuccess"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}}}
```

## Delete domain from system

> Удаление домена.

```json
{"openapi":"3.0.3","info":{"title":"Eternity Domains API","version":"1.0.0"},"servers":[{"url":"https://api.eternity.domains","description":"Main server"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"DeleteRequest":{"type":"object","properties":{"domain":{"type":"string"}},"required":["domain"]},"GenericSuccess":{"type":"object","properties":{"message":{"type":"string","description":"Человеко-читаемое сообщение"},"success":{"type":"boolean","description":"Флаг успеха"},"code":{"type":"integer","description":"Код операции, 0 — ok"}}},"ErrorResponse":{"type":"object","properties":{"error":{"type":"string","description":"Короткое сообщение об ошибке"},"code":{"type":"integer","description":"Внутренний код ошибки"},"details":{"type":"string","description":"Подробности ошибки — для отладки"}}}}},"paths":{"/api/v1/delete":{"delete":{"summary":"Delete domain from system","description":"Удаление домена.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeleteRequest"}}}},"responses":{"200":{"description":"Deleted","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GenericSuccess"}}}},"404":{"description":"Domain not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}}}
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docse.eternity.domains/eternity-domains-api.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
