developer
PTEN

Settings API

Domains

The company’s domains: asked for, shown to be its own by a TXT record, then with mail here or not.

Base URL https://acme.yet.com.br/api/settings

Settings answer at your company’s own address — acme here — and take a key of someone who runs them.

List domains

GET/api/settings/domains

Its domains, with whether each has mail here, and the ones still asked for (claims).

Who: Runs the company’s Settings

Request
curl https://acme.yet.com.br/api/settings/domains \
  -H "Authorization: Bearer $YET_API_KEY"
Response · 200
{
  "domains": [
    {
      "name": "acme.dev",
      "mail": true
    }
  ],
  "claims": [
    {
      "domain": "acme.com.br",
      "txt": "yet-verify=4f2a…",
      "created_at": "2026-10-23T12:00:00Z"
    }
  ]
}

Ask for a domain

POST/api/settings/domains

Answers with the TXT record to publish: once its DNS shows it, the domain is the company’s.

Who: Runs the company’s Settings

Body

namestringrequired
The domain.
Request
curl -X POST https://acme.yet.com.br/api/settings/domains \
  -H "Authorization: Bearer $YET_API_KEY" \
  -d '{
    "name": "acme.com.br"
  }'

Verify a domain

POST/api/settings/domains/claims/{domain}

Checks its DNS now and, when it shows the record, makes it the company’s.

Who: Runs the company’s Settings

Request
curl -X POST https://acme.yet.com.br/api/settings/domains/claims/{domain} \
  -H "Authorization: Bearer $YET_API_KEY"

Stop asking for a domain

DELETE/api/settings/domains/claims/{domain}

Gives up a claim not verified yet.

Who: Runs the company’s Settings

Request
curl -X DELETE https://acme.yet.com.br/api/settings/domains/claims/{domain} \
  -H "Authorization: Bearer $YET_API_KEY"

Publish the claim in Cloud

POST/api/settings/domains/claims/{domain}/cloud

Puts the TXT record in the domain’s zone in Cloud, making the zone first if need be.

Who: Runs the company’s Settings

Request
curl -X POST https://acme.yet.com.br/api/settings/domains/claims/{domain}/cloud \
  -H "Authorization: Bearer $YET_API_KEY"

A domain’s health

GET/api/settings/domains/{domain}

Its DNS as the internet sees it, its standing in SES and the week’s numbers.

Who: Runs the company’s Settings

Request
curl https://acme.yet.com.br/api/settings/domains/{domain} \
  -H "Authorization: Bearer $YET_API_KEY"

Turn its mail on

POST/api/settings/domains/{domain}/mail

The mail server, SES, and a mailbox for each of its people.

Who: Runs the company’s Settings

Request
curl -X POST https://acme.yet.com.br/api/settings/domains/{domain}/mail \
  -H "Authorization: Bearer $YET_API_KEY"

Publish its mail records in Cloud

POST/api/settings/domains/{domain}/dns

Puts the records its mail needs in the domain’s zone in Cloud.

Who: Runs the company’s Settings

Request
curl -X POST https://acme.yet.com.br/api/settings/domains/{domain}/dns \
  -H "Authorization: Bearer $YET_API_KEY"

Pause or resume its mail

PUT/api/settings/domains/{domain}

Paused, the domain sends nothing.

Who: Runs the company’s Settings

Body

pausedbooleanrequired
Whether it is paused.
Request
curl -X PUT https://acme.yet.com.br/api/settings/domains/{domain} \
  -H "Authorization: Bearer $YET_API_KEY" \
  -d '{
    "paused": true
  }'

Remove a domain

DELETE/api/settings/domains/{domain}

Only one with nobody on it.

Who: Runs the company’s Settings

Request
curl -X DELETE https://acme.yet.com.br/api/settings/domains/{domain} \
  -H "Authorization: Bearer $YET_API_KEY"