Create a site

Add a new site. Returns a validation_token needed to prove site ownership. Unverified sites are capped at 10 URLs per boost.

POST /v1/sites

Requires scope: sites:write

Body parameters

Parameter	Type	Required	Description
`domain`	string	Required	Domain without scheme or trailing slash. `https://` prefix is stripped automatically.

Example request

curl -X POST https://api.cache-boost.com/v1/sites \
  -H "Authorization: Bearer cb_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"domain": "www.example.com"}'

Response

Returns 201 Created with the new site object.

{
  "id": 42,
  "domain": "www.example.com",
  "validated": false,
  "validation_token": "a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4",
  "created_at": "2025-01-15T10:30:00Z"
}

Use the validation_token to verify site ownership. See the Allow traffic guide.

Errors

Code	Description
`401`	Missing or invalid API key.
`403`	Insufficient scope.
`422`	Validation error — missing or invalid `domain`.