---
title: "Propose Domain Purchase"
method: POST
path: "/v1/teams/{team_id}/domains/purchases"
tags: ["domains"]
---

# Propose Domain Purchase

`POST /v1/teams/{team_id}/domains/purchases`

## Request

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

Freeze one exact non-refundable purchase behind normal action policy.

## Path parameters

- `team_id` string, uuid, required

## Headers

- `authorization` string, nullable
- `x-darwin-token` string, nullable
- `x-darwin-run-id` string, nullable

## Request body

- PurchaseDomainRequest: Select one immutable quote; price and hostname stay backend-owned.
  - `quote_id` string, uuid, required
  - `include_www` boolean
  - `purpose` string, nullable
  - `work_item_id` string, uuid, nullable
  - `idempotency_key` string, nullable
  - `decide_by` string, date-time, nullable

## Response `202`

Successful Response

- object

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/stormy/apis/stormy-control-plane.md) · [All operations](https://skmtc.dev/stormy/apis/stormy-control-plane/llms.txt) · [OpenAPI document](https://skmtc.dev/stormy/apis/stormy-control-plane/revisions/4d811ab18158?raw)
