> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cloudservices.ecowestern.net/llms.txt
> Use this file to discover all available pages before exploring further.

# Waymark overview

> Understand custom domains and resource routing

Waymark connects custom hostnames to Flow functions, Canopy sites, and ClearLake buckets.

**Base path:** `/v1/waymark`

<CardGroup cols={3}>
  <Card title="Register" icon="plus-circle" href="/services/waymark/domains">
    Attach a hostname to an existing ECS resource.
  </Card>

  <Card title="Verify" icon="badge-check" href="/services/waymark/dns-routing">
    Point DNS at the returned target and monitor verification.
  </Card>

  <Card title="Route" icon="globe-2" href="/services/waymark/dns-routing">
    Serve the target resource from your own hostname.
  </Card>
</CardGroup>

## Supported targets

| Target            | Use case                                    |
| ----------------- | ------------------------------------------- |
| Flow              | Route API and webhook traffic to a function |
| Canopy            | Serve a static site from a custom hostname  |
| Public ClearLake  | Serve public objects from a custom hostname |
| Private ClearLake | Not supported through custom domains        |

## Permissions

| Capability              | Permission       |
| ----------------------- | ---------------- |
| Register a domain       | `waymark:write`  |
| List or inspect domains | `waymark:read`   |
| Delete a domain         | `waymark:delete` |

## Lifecycle

1. Register a hostname and target resource.
2. Add the returned CNAME target to DNS.
3. Wait for verification and certificate provisioning.
4. Poll the domain endpoint until `active`.
5. Delete the registration when the hostname is no longer needed.