# List Custom Domains for Site Slug

> List Custom Domains for Site Slug is a paid API for AI agents from host.withzero.ai, paid per call via MPP, metered — billed by usage, status unknown (last checked 2026-10-02).

Returns all custom domains currently attached to a specific hosted site slug, readable only by the slug owner.

## Facts

- Endpoint: GET https://host.withzero.ai/sites/:slug/domains?utm_source=zero.xyz
- Price: metered — billed by usage
- Payment: MPP
- Status: unknown
- Last checked: 2026-10-02
- Activations on Zero: 0
- Provider: host.withzero.ai
- Website: https://host.withzero.ai
- Canonical page: https://www.zero.xyz/c/host-withzero-ai-list-custom-domains-for-site-slug-109097d2
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_8vPySHIWpcmaZjvgCzNiS

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 host-withzero-ai-list-custom-domains-for-site-slug-109097d2
```

Example prompt: Can you show me all the custom domains that are currently attached to my site slug 'my-portfolio' on host.withzero.ai?

## When to prefer this

Use this endpoint when you need to programmatically audit, display, or verify which custom domains are attached to a specific hosted site slug on host.withzero.ai. Prefer this over manual Cloudflare dashboard checks when building automated site management workflows. Note that results reflect KV state only and may not match live DNS if domains were modified outside this API.

## Known failure modes

- Unauthorized (403) if the caller is not the slug owner
- Slug not found (404) if the slug does not exist
- Empty list returned if no custom domains are attached
- KV read errors may cause 500-level failures
- Stale data possible if Cloudflare DNS state diverged from KV

## How this service works

List custom domains attached to this slug. Owner-only. Reads from CUSTOM_DOMAINS KV (the same source the sites worker resolves at request time) — does not cross-check Cloudflare state.

## Output

An object listing all custom domains currently attached to the specified slug, sourced from the CUSTOM_DOMAINS KV store. Does not cross-check live Cloudflare DNS state — reflects only what is recorded in KV.

## Response schema (JSON Schema)

```json
{
 "type": "object"
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/host-withzero-ai-list-custom-domains-for-site-slug-109097d2/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from host.withzero.ai](https://www.zero.xyz/host/host.withzero.ai/llms.txt)