# Domains

A site is live on a Clave address as soon as it is published. A domain
puts it on the owner's own address as well.

## Onboard, then attach

1. **Onboard** the domain with `POST /v1/domains`. Clave reports the modes
   it supports, so an agent picks one by lookup rather than by being
   refused.
2. **Attach** it to a site with `POST /v1/domains/{id}/attach`.

The certificate and the DNS are automatic on attach.

## Clave does not register domains

`POST /v1/domains` onboards a domain the owner **already registered**.
There is no registrar here. An owner who has no domain buys one first.

## When a domain is ready

A domain is ready only when its `status` and its `ssl.status` are both
active. The status goes active before the certificate does, so a report on
the status alone would tell an owner the domain is live while the
certificate is still being issued.

## States that look like failures

`Moved` and `Deleted` are recoverable. Clave retries them on a schedule.

`Blocked` needs a person. It means the domain was flagged for abuse.

## Records

`GET /v1/domains/{id}/records` reads the DNS records of an onboarded
domain, and `POST` and `DELETE` write and remove them. This is for the
records the site needs, such as mail.

Read [Domains](/api/domains).

---

## Where this page sits

This is one page of the Clave documentation.
Read it as a web page at https://docs.heyclave.party/concepts/domains.
Every page has a `.md` address, and https://docs.heyclave.party/llms.txt lists them all.

- Previous: [Comments](https://docs.heyclave.party/concepts/comments.md)
- Next: [Forms](https://docs.heyclave.party/concepts/forms.md)
- Index: [Overview](https://docs.heyclave.party/index.md)