---
title: "Start Custom Domain Verification"
method: POST
path: "/users/me/handle/verify"
tags: ["Users"]
---

# Start Custom Domain Verification

`POST /users/me/handle/verify`

Generates a verification challenge for a custom domain handle. Returns the DNS TXT record and well-known file content to add for verification.

## Request body

- VerifyHandleRequest — Request to initiate handle verification
  - `handle` string, required — The domain to verify

## Response `200`

- VerificationChallenge — Verification challenge sent to the user
  - `createdAt` string, date-time, required — When this challenge was created
  - `dnsTxtName` string, required — The DNS TXT record name (subdomain)
  - `dnsTxtRecord` string, required — The DNS TXT record to add
  - `entityId` string, uuid, required — The entity ID
  - `entityType` string, required — The entity type (user or space)
  - `handle` string, required — The domain being verified
  - `nonce` string, required — Random nonce for this challenge
  - `wellKnownContent` string, required — The well-known file content
  - `wellKnownUrl` string, required — The well-known file URL

---

[API](https://skmtc.net/mikotoio/apis/mikoto-superego.md) · [All operations](https://skmtc.net/mikotoio/apis/mikoto-superego/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/mikotoio/mikoto-superego/revisions/2884da9c4ee0/schema)