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

# Start Custom Domain Verification

`POST /users/me/handle/verify`

## Request

- The document declares no server URL.
- Auth: none declared

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

## Changes

- **2026-02-12** `dd3f383f6c9b`: 1 info
  - endpoint added
- **2025-09-22** `2792e551a954`: 1 breaking
  - api path removed without deprecation

[Operation history](https://skmtc.dev/mikotoio/apis/mikoto-superego/changes/users/me/handle/verify/post.md)

---

[API](https://skmtc.dev/mikotoio/apis/mikoto-superego.md) - [All operations](https://skmtc.dev/mikotoio/apis/mikoto-superego/llms.txt) - [OpenAPI document](https://skmtc.dev/mikotoio/apis/mikoto-superego/revisions/55ae42443991?raw)
