---
title: "Changes to Domains"
method: POST
path: "/v1/domains"
---

# Changes to Domains

`POST /v1/domains`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 5 of 11 revisions.

- **2026-11-01** `120f2dd4c855`: 7 info
- **2026-10-23** `9edc3bfe1b9c`: 2 info
- **2026-10-19** `8134f9a5b206`: 3 breaking, 23 info
- **2026-09-25** `fcd4ea70588a`: 1 info
- **2026-08-29** `2e9e8abc82a5`: 1 info

## Changes

- **2026-11-01** `120f2dd4c855`: 7 info
  - added the optional property `detail/caller_error` to the response with the `401` status
  - added the optional property `detail/caller_error` to the response with the `402` status
  - added the optional property `detail/caller_error` to the response with the `403` status
  - added the optional property `detail/caller_error` to the response with the `429` status
  - added the optional property `error/anyOf[subschema #1: UnifiedError]/caller_error` to the response with the `200` status
  - added the optional property `metadata/capability` to the response with the `200` status
  - added the optional property `metadata/params` to the response with the `200` status
- **2026-10-23** `9edc3bfe1b9c`: 2 info
  - added the optional property `detail/items/ctx` to the response with the `422` status
  - added the optional property `detail/items/input` to the response with the `422` status
- **2026-10-19** `8134f9a5b206`: 3 breaking, 23 info
  - the `search_options/anyOf[#/components/schemas/DomainSearchOptions -> subschema #1: DomainSearchOptions]/` request property type changed from no type to `object`
  - the response's body type changed from no type to `object` for status `200`
  - the `detail/items/` response's property type changed from no type to `object` for status `422`
  - api operation id `unified_domains_v1_domains_post` removed and replaced with `domains`
  - api tag `Suprsonic` added
  - api tag `Unified APIs` removed
  - added the new optional request property `search_options/anyOf[#/components/schemas/DomainSearchOptions -> subschema #1: DomainSearchOptions]/allow_premium`
  - added the new optional request property `search_options/anyOf[#/components/schemas/DomainSearchOptions -> subschema #1: DomainSearchOptions]/hacks`
  - added the new optional request property `search_options/anyOf[#/components/schemas/DomainSearchOptions -> subschema #1: DomainSearchOptions]/max_annual_price`
  - added the new optional request property `search_options/anyOf[#/components/schemas/DomainSearchOptions -> subschema #1: DomainSearchOptions]/max_label_length`
  - added the new optional request property `search_options/anyOf[#/components/schemas/DomainSearchOptions -> subschema #1: DomainSearchOptions]/max_registration_total`
  - added the new optional request property `search_options/anyOf[#/components/schemas/DomainSearchOptions -> subschema #1: DomainSearchOptions]/max_renewal_price`
  - added the new optional request property `search_options/anyOf[#/components/schemas/DomainSearchOptions -> subschema #1: DomainSearchOptions]/max_total_length`
  - added the new optional request property `search_options/anyOf[#/components/schemas/DomainSearchOptions -> subschema #1: DomainSearchOptions]/priorities`
  - added the non-success response with the status `401`
  - added the non-success response with the status `402`
  - added the non-success response with the status `403`
  - added the non-success response with the status `429`
  - added the optional property `credits_used` to the response with the `200` status
  - added the optional property `data` to the response with the `200` status
  - added the optional property `error` to the response with the `200` status
  - added the optional property `metadata` to the response with the `200` status
  - added the required property `detail/items/loc` to the response with the `422` status
  - added the required property `detail/items/msg` to the response with the `422` status
  - added the required property `detail/items/type` to the response with the `422` status
  - added the required property `success` to the response with the `200` status
- **2026-09-25** `fcd4ea70588a`: 1 info
  - added the new optional request property `search_options`
- **2026-08-29** `2e9e8abc82a5`: 1 info
  - endpoint added

---

[Operation](https://skmtc.dev/suprsonic/apis/suprsonic-unified-agent-api/docs/v1/domains/post.md) - [API](https://skmtc.dev/suprsonic/apis/suprsonic-unified-agent-api.md) - [Page](https://skmtc.dev/suprsonic/apis/suprsonic-unified-agent-api/changes/v1/domains/post)