# Verify org domain DNS TXT

> Source: https://elaichi.ai/docs/api-reference/org-domains/org-domain/verifyorgdomain/

`POST /org-domain/{id}/verify`

Resource: **Org Domain** · API: **Org domains**

## Path parameters

- **`id`** _(string, required)_
  Org domain id.

## Response body

- **`id`** _(string)_
  Org domain id.
- **`organization_id`** _(string)_
  Owning organization (`org_…`).
- **`domain`** _(string)_
  DNS name, lowercased (e.g. `acme.com`).
- **`verified`** _(boolean)_
  Outcome of this attempt.
- **`verification_record`** _(string,null)_
  The exact DNS TXT value to publish. Present until the domain is verified, then null — the token is of no further use.
- **`default_role_id`** _(string,null)_
  Role (`role_…`) explicitly configured for domain auto-join, or null to track the default. Org Owner is refused here. Read `effective_default_role_id` to learn what a join actually grants.
- **`effective_default_role_id`** _(string,null)_
  Server-computed: the role a verified-domain auto-join really grants. Equals `default_role_id` when that is set and the role still exists; otherwise the **Member** system role, which is what the join falls back to both when nothing is configured and when the configured role has since been deleted. `null` means even that fallback is missing, so auto-join on this domain fails rather than seating anyone.
- **`sso_connection_id`** _(string,null)_
  Linked SSO connection (`sso_…`).
- **`created_at`** _(string)_
- **`updated_at`** _(string)_
- **`detail`** _(string,null)_
  Why verification failed, when it did.

## Code examples

### curl

```bash
curl -X POST 'https://api.elaichi.ai/org-domain/<id>/verify' \
  -H 'Authorization: Bearer $ELAICHI_API_TOKEN' \
  -H 'Content-Type: application/json'
```

### JavaScript

```javascript
const response = await fetch('https://api.elaichi.ai/org-domain/<id>/verify', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer ' + process.env.ELAICHI_API_TOKEN,
    'Content-Type': 'application/json',
  },
});

const data = await response.json();
console.log(data);
```

### Python

```python
import os
import requests

url = "https://api.elaichi.ai/org-domain/<id>/verify"
headers = {
    "Authorization": f"Bearer {os.environ['ELAICHI_API_TOKEN']}",
    "Content-Type": "application/json",
}

response = requests.post(url, headers=headers)
print(response.json())
```