Start Domain Claim

POST

/v1/mcp/{listing_id}/claim/domain

Send

Authorization

Path

Query

Request a DNS TXT verification token to claim a listing by domain.

Authorization: any authenticated user.

The domain is derived from the listing itself (homepage_url, falling back to source_url) - not supplied by the caller - so a claim can only ever target the domain the listing already advertises. Each user has their own independent pending attempt per listing: starting a new attempt only overwrites that same caller's previous attempt for this listing, never another user's.

Path Parameters

Query Parameters

Response Body

curl -X POST "https://example.com/v1/mcp/497f6eca-6276-4993-bfeb-53cbbbba6f08/claim/domain"

{  "domain": "string",  "verification_token": "string",  "dns_record_name": "string",  "dns_record_value": "string"}

{  "detail": [    {      "loc": [        "string"      ],      "msg": "string",      "type": "string"    }  ]}