# BRAINIAC Custom Domain Onboarding Audit

> BRAINIAC Custom Domain Onboarding Audit is a paid API for AI agents from www.brainiac.software, paid per call via x402, $0.05/call, status unknown (last checked 2026-11-13).

Audits caller-supplied custom domain onboarding metadata for DNS dangling, tenant binding conflicts, certificate mismatches, and ownership verification issues without making live DNS or HTTP queries.

## Facts

- Endpoint: POST https://www.brainiac.software/api/v1/domain-security/custom-domain-onboarding-audit?utm_source=zero.xyz
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/brainiac-custom-domain-onboarding-audit-5a6bcbe2
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap__Z8UdHvHokHkL5HeDfdtA

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability brainiac-custom-domain-onboarding-audit-5a6bcbe2 -d '<json body>'
```

Example prompt: Audit the custom domain onboarding for shop.example.com — it has a CNAME pointing to sites.platform.test which is marked unassigned, the tenant is tenant-a, the previous tenant was tenant-b with status removed, and the certificate SANs don't include the domain. Tell me the risk level and what actions to take.

## When to prefer this

Use this endpoint when you need a fast, stateless security audit of caller-supplied domain onboarding metadata — particularly to detect dangling DNS targets, tenant binding conflicts, certificate mismatches, or failed ownership verification — without triggering live DNS queries or modifying any platform state. It is ideal for SaaS platforms that manage custom domains for tenants and want to validate onboarding records before activation. Prefer this over live DNS lookup tools when you already have the metadata and want a structured risk assessment with recommended actions.

## Known failure modes

- Missing required fields (domain, targets) returns a validation error
- Invalid tenant pattern or domain format causes schema rejection
- Supplying no assignment records may result in incomplete dangling DNS assessment
- CheckedAt timestamp with invalid format or non-existent leap date is rejected
- Empty targets array (minItems:1) causes request failure
- Ambiguous or conflicting status enums may produce indeterminate audit status

## How this service works

Pay-per-call APIs for AI agents: OFAC sanctions screening, compliance checks, token security, and Base chain data via x402. No account. Fixed USDC price. MCP-ready.

## Output

Returns a structured audit report including: overall risk_level (e.g. high/medium/low), audit_status (e.g. takeover_risk, verified, unverified), dns_target_status with detail and list of dangling targets, certificate_findings array with specific codes and details per hostname, tenant_binding_status showing conflicts and tenant identifiers, ownership_verification result, recommended_actions with action codes and explanations, and a list of limitations clarifying what the audit did and did not check.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "token": {
   "type": "string",
   "maxLength": 200,
   "minLength": 8
  },
  "domain": {
   "type": "string",
   "maxLength": 253,
   "minLength": 1
  },
  "status": {
   "enum": [
    "pending",
    "active",
    "removed"
   ],
   "type": "string"
  },
  "tenant": {
   "type": "string",
   "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]{0,63}$"
  },
  "records": {
   "type": "array",
   "items": {
    "type": "object",
    "required": [
     "type",
     "name",
     "value"
    ],
    "properties": {
     "name": {
      "type": "string",
      "maxLength": 253,
      "minLength": 1
     },
     "type": {
      "enum": [
       "A",
       "AAAA",
       "CNAME",
       "TXT"
      ],
      "type": "string"
     },
     "value": {
      "type": "string",
      "maxLength": 1024,
      "minLength": 1
     }
    },
    "additionalProperties": false
   },
   "maxItems": 64
  },
  "targets": {
   "type": "array",
   "items": {
    "type": "object",
    "required": [
     "kind",
     "value"
    ],
    "properties": {
     "kind": {
      "enum": [
       "A",
       "AAAA",
       "CNAME"
      ],
      "type": "string"
     },
     "value": {
      "type": "string",
      "maxLength": 253,
      "minLength": 1
     }
    },
    "additionalProperties": false
   },
   "maxItems": 16,
   "minItems": 1
  },
  "previous": {
   "type": "object",
   "required": [
    "tenant",
    "domain",
    "status"
   ],
   "properties": {
    "domain": {
     "type": "string",
     "maxLength": 253,
     "minLength": 1
    },
    "status": {
     "enum": [
      "pending",
      "active",
      "removed"
     ],
     "type": "string"
    },
    "tenant": {
     "type": "string",
     "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]{0,63}$"
    }
   },
   "additionalProperties": false
  },
  "checkedAt": {
   "type": "string",
   "format": "date-time",
   "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
  },
  "assignments": {
   "type": "array",
   "items": {
    "type": "object",
    "required": [
     "hostname",
     "status"
    ],
    "properties": {
     "status": {
      "enum": [
       "assigned",
       "unassigned",
       "deleted"
      ],
      "type": "string"
     },
 
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "risk_level": "high",
  "limitations": [
   "The audit compares caller-supplied records only. It does not query DNS, HTTP, or TLS, and it does not claim or change a domain.",
   "A dangling DNS target is a potential condition only when the supplied assignment status is unassigned or deleted. It is not proof of a takeover.",
   "A missing TXT record is missing evidence. A TXT record that does not match is a verification failure. Neither one is a takeover condition by itself.",
   "The verification token is not repeated in this result.",
   "Certificate names are compared only when certificate metadata is supplied."
  ],
  "audit_status": "takeover_risk",
  "dns_target_status": {
   "detail": "A supplied CNAME points at a platform hostname the caller marked unassigned or deleted. This is not proof of a takeover.",
   "status": "dangling",
   "targets": [
    "sites.platform.test"
   ]
  },
  "recommended_actions": [
   {
    "code": "verify_assignment",
    "detail": "Confirm the platform assignment before reusing or repointing the hostname. A dangling DNS target is not proof of a takeover, and this audit did not claim the domain."
   },
   {
    "code": "review_certificate",
    "detail": "Review the supplied certificate name and validity. This comparison does not connect to the domain."
   },
   {
    "code": "review_tenants",
    "detail": "Review the supplied tenant associations before treating the domain as bound to one customer."
   }
  ],
  "certificate_findings": [
   {
    "code": "certificate_name_mismatch",
    "name": "shop.example.com",
    "detail": "The supplied certificate names do not include this domain. This is an identity mismatch, not a takeover condition."
   },
   {
    "code": "certificate_expired",
    "name": "shop.example.com",
    "detail": "The supplied certificate was expired at checkedAt. This is not a takeover condition."
   }
  ],
  "tenant_binding_status": {
   "detail": "A removed domain is still associated with a different active tenant in the supplied records.",
   "status": "conflict",
   "tenant": "tenant-a",
   "previous_tenant": "tenant-b"
  },
  "ownership_verification": {
   "detail": "A supplied TXT value matches the expected verification token. The token is not repeated here.",
   "status": "matched",
   "records": 2
  },
  "dangling_target_findings": [
   {
    "detail": "The supplied assignment says this platform hostname is not in use. A dangling name is not proof that the dom
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/brainiac-custom-domain-onboarding-audit-5a6bcbe2/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from www.brainiac.software](https://www.zero.xyz/host/www.brainiac.software/llms.txt)
