experience

Verify domain connections

Check that your organization controls every host a connected website approves, and record the answer on the connection. A host is proven by a domain your organization verified for single sign-on (it or a parent of it), or by the TXT record the connection's domainVerification.record names, published at the host or a parent domain. Until every host is proven, journeys treat the website as one you do not own: robots.txt and the full site fence, no test actions, no sign-in, no iPhone Safari. A record that is not there yet answers verified false with the hosts left; a DNS or single sign-on lookup that does not answer is retryable and records nothing. Pass the revision you read; verifying does not change it.

post/api/v1/experience/connections/verify-domain

Request

  • Base URL: https://point11.ai
  • URL: https://point11.ai/api/v1/experience/connections/verify-domain
  • Auth: one of:
    • HTTP bearer
    • OAuth 2 (authorization code, authorization URL https://auth.point11.ai/oauth2/authorize, token URL https://auth.point11.ai/oauth2/token)

Headers

Point11-Organizationstring uuid

Organization to act in. Required for OAuth bearers; an API key acts in the organization that owns it.

Idempotency-Keystring uuid required

UUID naming this intent. Retry with the same key; reuse for other input is 409.

Request body

idstring uuid required
expectedRevisioninteger required

Response

Success.

verifiedboolean required
unprovenstring[] required

The hosts no proof covers yet; empty once verified.

Changes

No recorded changes to this operation across all 1 revision of this API.