Content Management

Verify Guide Domain

Changed on

Check the ownership TXT record and, on success, activate the domain.

This is the gate. Everything before it is a claim; provisioning a certificate for a hostname nobody has proved they control would let one tenant take an address that already resolves to us.

post/api/v1/content/domains/{domain_id}/verify

Request

  • Base URL: https://api.getanana.com (the document declares no server; this is the origin it was published from)
  • URL: https://api.getanana.com/api/v1/content/domains/{domain_id}/verify
  • Auth: none declared

Path parameters

domain_idstring uuid required

Response

Successful Response

idstring uuid required
hostnamestring required
kind'CNAME_SINGLE' | 'CNAME_GROUP' | 'WORKER' required

How a hostname reaches us, and therefore what it can serve.

Named for the SHAPE of the address, not the vendor mechanism — the operator never sees "CNAME" or "Worker", and the two questions that determine this (own host or folder? one guide or several?) are the ones the UI asks.

path_prefixstring nullable required
addressstring required
state'needs_verification' | 'needs_dns' | 'pointing_elsewhere' | 'securing' | 'ready' | 'live' | 'action_needed' | 'check_unavailable' required
messagestring required
actionstring nullable
expected_recordstring nullable
observed_targetstring nullable
tls_statusstring nullable
ownership_recordstring nullable
ownership_tokenstring nullable
verifiedboolean

Changes

  • d65b8fefae34Revision changes
    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status