Listar domínios do site

curl

curl https://app.cubehosting.com.br/api/projects/$PROJECT_ID/domains \
  -H "Authorization: Bearer $CUBE_API_KEY"

const API = 'https://app.cubehosting.com.br/api';
const headers = { Authorization: `Bearer ${process.env.CUBE_API_KEY}` };

const res = await fetch(`${API}/projects/${process.env.PROJECT_ID}/domains`, { headers });
const { domains } = await res.json();
for (const d of domains) for (const r of d.records) console.log(d.hostname, r.type, r.name, r.value, r.isOk);

import os
import requests

API = "https://app.cubehosting.com.br/api"
headers = {"Authorization": f"Bearer {os.environ['CUBE_API_KEY']}"}

r = requests.get(f"{API}/projects/{os.environ['PROJECT_ID']}/domains", headers=headers, timeout=30)
r.raise_for_status()
for d in r.json()["domains"]:
    for rec in d["records"]:
        print(d["hostname"], rec["type"], rec["name"], rec["value"], rec["isOk"])

{
  "domains": [
    {
      "id": "01JA9K3M5P7R9T1V3X5Z7B9D1F",
      "projectId": "01J8Z4B2QK7M3V9T0XW5R6N8CD",
      "hostname": "loja.com.br",
      "redirectTo": null,
      "status": "active",
      "error": null,
      "records": [
        {
          "type": "CNAME",
          "name": "loja.com.br",
          "value": "domains.cubehost.dev",
          "isOk": true
        },
        {
          "type": "TXT",
          "name": "_cube-verify.loja.com.br",
          "value": "cube-verify=4a4163549b3f77ae5fbfff6fa7480999",
          "isOk": true
        }
      ],
      "verifiedAt": "2026-09-28T15:11:01.597Z",
      "checkedAt": "2026-09-28T15:21:02.114Z",
      "createdAt": "2026-09-28T15:09:40.000Z",
      "project": {
        "id": "01J8Z4B2QK7M3V9T0XW5R6N8CD",
        "name": "Loja"
      }
    },
    {
      "id": "01JA9K3M5P7R9T1V3X5Z7B9D1G",
      "projectId": "01J8Z4B2QK7M3V9T0XW5R6N8CD",
      "hostname": "www.loja.com.br",
      "redirectTo": "loja.com.br",
      "status": "pending",
      "error": null,
      "records": [
        {
          "type": "CNAME",
          "name": "www.loja.com.br",
          "value": "domains.cubehost.dev",
          "isOk": false
        },
        {
          "type": "TXT",
          "name": "_cube-verify.loja.com.br",
          "value": "cube-verify=4a4163549b3f77ae5fbfff6fa7480999",
          "isOk": true
        }
      ],
      "verifiedAt": "2026-09-28T15:11:01.597Z",
      "checkedAt": "2026-09-28T15:21:02.114Z",
      "createdAt": "2026-09-28T15:09:40.000Z",
      "project": {
        "id": "01J8Z4B2QK7M3V9T0XW5R6N8CD",
        "name": "Loja"
      }
    }
  ],
  "used": 2,
  "limit": 10,
  "target": "domains.cubehost.dev",
  "isAvailable": true
}

GET

projects

{id}

domains

curl

curl https://app.cubehosting.com.br/api/projects/$PROJECT_ID/domains \
  -H "Authorization: Bearer $CUBE_API_KEY"

const API = 'https://app.cubehosting.com.br/api';
const headers = { Authorization: `Bearer ${process.env.CUBE_API_KEY}` };

const res = await fetch(`${API}/projects/${process.env.PROJECT_ID}/domains`, { headers });
const { domains } = await res.json();
for (const d of domains) for (const r of d.records) console.log(d.hostname, r.type, r.name, r.value, r.isOk);

import os
import requests

API = "https://app.cubehosting.com.br/api"
headers = {"Authorization": f"Bearer {os.environ['CUBE_API_KEY']}"}

r = requests.get(f"{API}/projects/{os.environ['PROJECT_ID']}/domains", headers=headers, timeout=30)
r.raise_for_status()
for d in r.json()["domains"]:
    for rec in d["records"]:
        print(d["hostname"], rec["type"], rec["name"], rec["value"], rec["isOk"])

{
  "domains": [
    {
      "id": "01JA9K3M5P7R9T1V3X5Z7B9D1F",
      "projectId": "01J8Z4B2QK7M3V9T0XW5R6N8CD",
      "hostname": "loja.com.br",
      "redirectTo": null,
      "status": "active",
      "error": null,
      "records": [
        {
          "type": "CNAME",
          "name": "loja.com.br",
          "value": "domains.cubehost.dev",
          "isOk": true
        },
        {
          "type": "TXT",
          "name": "_cube-verify.loja.com.br",
          "value": "cube-verify=4a4163549b3f77ae5fbfff6fa7480999",
          "isOk": true
        }
      ],
      "verifiedAt": "2026-09-28T15:11:01.597Z",
      "checkedAt": "2026-09-28T15:21:02.114Z",
      "createdAt": "2026-09-28T15:09:40.000Z",
      "project": {
        "id": "01J8Z4B2QK7M3V9T0XW5R6N8CD",
        "name": "Loja"
      }
    },
    {
      "id": "01JA9K3M5P7R9T1V3X5Z7B9D1G",
      "projectId": "01J8Z4B2QK7M3V9T0XW5R6N8CD",
      "hostname": "www.loja.com.br",
      "redirectTo": "loja.com.br",
      "status": "pending",
      "error": null,
      "records": [
        {
          "type": "CNAME",
          "name": "www.loja.com.br",
          "value": "domains.cubehost.dev",
          "isOk": false
        },
        {
          "type": "TXT",
          "name": "_cube-verify.loja.com.br",
          "value": "cube-verify=4a4163549b3f77ae5fbfff6fa7480999",
          "isOk": true
        }
      ],
      "verifiedAt": "2026-09-28T15:11:01.597Z",
      "checkedAt": "2026-09-28T15:21:02.114Z",
      "createdAt": "2026-09-28T15:09:40.000Z",
      "project": {
        "id": "01J8Z4B2QK7M3V9T0XW5R6N8CD",
        "name": "Loja"
      }
    }
  ],
  "used": 2,
  "limit": 10,
  "target": "domains.cubehost.dev",
  "isAvailable": true
}

O status vai de pending (verificando) a active quando a Cube acha o TXT que prova a posse e o CNAME chegando a domains.cubehost.dev. A Cube confere sozinha a cada minuto: releia esta rota ou chame Verificar domínio agora.

Erros comuns

Código	HTTP	O que fazer
`not_found`	404	Confira o `id` do site em Listar projetos.
`invalid_api_key`	401	Confira o cabeçalho `Authorization: Bearer <chave>`.

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_….

Parâmetros de caminho

string

obrigatório

O ID do projeto (26 caracteres). Aparece no painel, no topo do projeto, e em GET /projects.

Pattern: ^[0-9A-HJKMNP-TV-Z]{26}$

Exemplo:

"01J8Z3W6N0Q4Y7V2K5T9D1H3XA"

Resposta

Os domínios do site.

domains

object[]

obrigatório

Show child attributes

used

integer

obrigatório

Quantos domínios a conta tem, somando os sites.

limit

integer

obrigatório

O limite do plano: 0 abaixo do Tower; Tower 10, Fortress 20, Monolith 40.

target

string

obrigatório

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

isAvailable

boolean

obrigatório

false enquanto o domínio próprio ainda não está liberado para a conta (em breve).

Visão geral

Projetos

Templates

Controle

Logs e métricas

Variáveis de ambiente

Backups

Versões dos envios

Bancos de dados

Blob

Domínios

Avisos

Conta

Listar domínios do site

Erros comuns

Autorizações

Parâmetros de caminho

Resposta

​Erros comuns

Autorizações

Parâmetros de caminho

Resposta

Erros comuns