---
title: "Begin proving that this organization controls a domain. For an agent's account the domain stands in for an email: it lifts the limits, opens full Beacon reports, and recovers the account if the key is lost"
method: POST
path: "/api/v1/org/domain"
tags: ["Onboarding"]
---

# Begin proving that this organization controls a domain. For an agent's account the domain stands in for an email: it lifts the limits, opens full Beacon reports, and recovers the account if the key is lost

`POST /api/v1/org/domain`

## Request

- Base URL: `https://overwing.ai`
- URL: `https://overwing.ai/api/v1/org/domain`
- Auth: HTTP bearer

## Request body

- object
  - `domain` string, required

## Response `200`

The value to publish at the domain

- DomainProof
  - `domain` string
  - `status` 'pending_verification' | 'verified'
  - `verification` object: The one value to publish at the domain, as a DNS TXT record or as a file
    - `value` string
    - `dns` object
      - `type` string
      - `name` string
      - `value` string
    - `http` object
      - `url` string
      - `body` string
  - `next` string

## Other responses

- `400`: domain is not a public hostname
- `401`: Missing or invalid API key
- `409`: The domain is already verified by another account

---

[API](https://skmtc.dev/overwing/apis/overwing-api.md) · [All operations](https://skmtc.dev/overwing/apis/overwing-api/llms.txt) · [OpenAPI document](https://skmtc.dev/overwing/apis/overwing-api/revisions/ff1282d31438?raw)