Pular para o conteúdo principal
GET
curl
Cada domínio vem com o site que ele abre (project), o status e, em records, os registros para criar no DNS dele: o CNAME e o TXT de posse. Na raiz com ALIAS (ou CNAME achatado), o certificado não sai, e o domínio vem com error.code: "root_alias_unsupported". A conta tem um pacote de domínios, dividido entre os sites, e o www do mesmo nome no mesmo site vai junto sem contar: used é quantos domínios contam, limit é o pacote do plano (0 no Free, que não tem site) e suggestedPlanId é o plano mais barato com mais domínios (null no maior). Depois de mudar para um plano menor, used pode passar do limit: os domínios continuam no ar. Com isAvailable: false, o domínio próprio está fora do ar agora. Guia em Endereço e domínios.

Erros comuns

Todos os códigos, com o formato do erro, em Códigos de erro.

Autorizações

Authorization
string
header
obrigatório

Chave de API da Cube (cube_…), criada no painel em Chaves de API. Mande como Authorization: Bearer cube_…. Cada rota pede uma permissão da chave (o escopo no security da rota, como files:write); sem ela, 403 insufficient_scope com o requiredScope. Veja Chaves de API.

Scopes

domains:read

Resposta

Os domínios da conta.

domains
object[]
obrigatório
used
integer
obrigatório

Quantos domínios da conta contam no pacote (o www do mesmo nome no mesmo site vai junto e não conta). Pode passar do limit depois de mudar para um plano menor: os domínios continuam no ar. Até 28/10/2026: os sites com domínio (no site, 0 ou 1).

limit
integer
obrigatório

O pacote de domínios da conta (0 no Free, que não tem site, e num bot). Até 28/10/2026: 1 por site.

suggestedPlanId
string | null
obrigatório

O plano mais barato com mais domínios que o pacote e que o used; null no maior.

target
string
obrigatório

O alvo do CNAME (domains.cubehost.dev).

isAvailable
boolean
obrigatório

false quando o domínio próprio está fora do ar.