Domain verify

When it is required

Console (My Account)

1. 0

   Open Scout → Domains

   Sign in at account.macrocontent.dev → Scout → Domains. Domains are account-scoped: every sk_scout_… key on the account can use them.

2. 0

   Add hostname

   Enter the host you own (e.g. www.example.com or example.com). Scout creates a pending domain and shows a challenge value.

3. 0

   Publish the challenge

   • DNS TXT (preferred): create a TXT record at _scout-verify.<hostname> with the exact challenge value (form scout-verify=<token>). Apex TXT with the same value is also accepted.
   • Well-known file: serve https://<hostname>/.well-known/scout-verify.txt whose body is the same challenge value (plain text).
4. 0

   Click Verify

   Scout checks DNS and/or the well-known file. On success the status becomes verified. Re-verify is required after ~90 days (configurable).

API flow

1. 0

   Register the hostname

   POST/v1/domainsAPI key

   Creates (or returns) a pending domain + challenge. 0 credits.

   bash Copy

   curl -X POST https://scout.macrocontent.dev/v1/domains \
     -H "Authorization: Bearer sk_scout_…" \
     -H "Content-Type: application/json" \
     -d '{"hostname":"example.com"}'

   Example response fields:

   json Copy

   {
     "id": "dom_…",
     "hostname": "example.com",
     "status": "pending",
     "challenge": {
       "type": "dns_txt",
       "name": "_scout-verify.example.com",
       "value": "scout-verify=…",
       "token": "…"
     },
     "verified_at": null
   }

2. 0

   List / inspect

   GET/v1/domainsAPI key

   List domains for this key’s account. 0 credits.

   GET/v1/domains/:idAPI key

   Fetch one domain by id (dom_…). 0 credits.

   bash Copy

   curl https://scout.macrocontent.dev/v1/domains \
     -H "Authorization: Bearer sk_scout_…"

3. 0

   Prove ownership, then verify

   Publish DNS TXT or the well-known file using challenge.name / challenge.value from the create response.

   POST/v1/domains/:id/verifyAPI key

   Checks DNS TXT and/or /.well-known/scout-verify.txt. 0 credits.

   bash Copy

   curl -X POST https://scout.macrocontent.dev/v1/domains/dom_…/verify \
     -H "Authorization: Bearer sk_scout_…"

4. 0

   Remove (optional)

   DELETE/v1/domains/:idAPI key

   Delete a domain registration. 0 credits.

Using a verified domain

For a sensitive journey, every navigate URL host must match a verified hostname (exact host or a verified parent, e.g. verified example.com covers www.example.com).

{
  "steps": [
    { "type": "navigate", "url": "https://example.com/login" },
    { "type": "interact", "action": "fill", "selector": "#email", "text": "demo.user" },
    { "type": "interact", "action": "click", "selector": "button[type=submit]" },
    { "type": "extract", "fields": [{ "name": "welcome", "selector": "h1", "type": "text" }] }
  ]
}

Parameters (create)