v1

latestOpenAPI 3.1.02026-07-2210284274.4 KB
Property Resolution

Claim a domain for bind-on-verify

Issue a pending domain claim for the caller's organization and return a claim-specific authoritative_location URL (…/adagents.json?adcp_claim=<token>). The caller places that single pointer at their own origin /.well-known/adagents.json; a subsequent verify-origin reads the token and binds the domain to the caller's org. The token is the per-account artifact that proves WHICH account owns the domain — a plain domain-keyed pointer proves only that the origin endorses AAO hosting, not who the owner is.

The community write surface stays open; this does not gate writes — it establishes ownership on successful verification. Refused with 409 only when the domain is already verified and locked to a different owner.

post/api/properties/hosted/{domain}/claim

Path parameters

domainstring required
Example:examplepub.com

Response

Claim issued

successtrue required
domainstring required
authoritative_locationstring required
instructionsstring required