# Flowg8 · Verify domain TXT

Resolve the challenge and reserve the verified domain for the organization.

409 DOMAIN_NOT_VERIFIED means the expected TXT is not visible yet. 409 DOMAIN_IN_USE means another organization already owns the verified domain. Retrying after DNS propagation needs a new Idempotency-Key.

## POST /v1/organization/domains/{domainId}/verify

Authentication: FLOWG8_ACCESS_TOKEN from Flowg8 sign-in
Required tenant header: X-Organization-Id.
Required user permissions: Administrator role required. The API checks current membership, roles, key scopes and resource permissions on every request. Documentation visibility grants no access.

## Request example (replace example IDs)

```sh
curl -X POST "https://api.flowg8.io/v1/organization/domains/10000000-0000-4000-8000-000000000014/verify" \
  -H "authorization: Bearer $FLOWG8_ACCESS_TOKEN" \
  -H "x-organization-id: 10000000-0000-4000-8000-000000000001" \
  -H "idempotency-key: example-verify-domain-001" \
  -H "content-type: application/json" \
  --data-raw '{}'
```

Source: /docs/verify-domain
Full schemas: /docs/openapi.json
