> ## Documentation Index > Fetch the complete documentation index at: https://docs.cubehosting.com.br/llms.txt > Use this file to discover all available pages before exploring further. # Trocar para onde o domínio vai > Faça o domínio redirecionar para outro do site, ou abrir o site direto. Para inverter o `www` (a raiz passa a levar ao `www`), mande `{ "redirectTo": "www.loja.com.br" }` no domínio da raiz: no mesmo pedido, o `www` passa a abrir o site. O redirecionamento é um `308` que mantém o caminho (`/produtos?x=1`). ## Erros comuns | Código | HTTP | O que fazer | | ------------------------------------------------------------------ | ---- | ------------------------------------------------------------------------------------------------ | | [`invalid_redirect`](/errors#param-invalid-redirect) | 422 | Escolha outro domínio deste site que abre o site direto. | | [`not_found`](/errors#param-not-found) | 404 | Confira o `id` do site e o `domainId` em [Listar domínios do site](/api-reference/domains/list). | | [`insufficient_permission`](/errors#param-insufficient-permission) | 403 | Use uma chave de leitura e escrita. | Todos os códigos, com o formato do erro, em [Códigos de erro](/errors). ## OpenAPI ````yaml PATCH /projects/{id}/domains/{domainId} openapi: 3.1.0 info: title: API da Cube Hosting version: 1.0.0 description: >- Hospede bots de Discord, sites e APIs em Node.js e Python: envie o .zip, inicie, pare, reinicie, leia logs e métricas, cuide das variáveis de ambiente, faça e baixe backups, volte para uma versão anterior, crie bancos de dados (PostgreSQL, MySQL, MongoDB e Redis), guarde arquivos privados no Blob, use um domínio seu nos sites e veja o uso do plano. Para agentes de IA, o servidor MCP da conta (`POST https://app.cubehosting.com.br/api/mcp`, JSON-RPC, com a mesma chave) está em https://docs.cubehosting.com.br/account-mcp. contact: name: Cube Hosting url: https://discord.gg/pv6D9tUsDV servers: - url: https://app.cubehosting.com.br/api security: - bearerAuth: [] tags: - name: Projetos - name: Controle - name: Logs e métricas - name: Variáveis de ambiente - name: Backups - name: Versões dos envios - name: Bancos de dados - name: Blob - name: Domínios - name: Templates - name: Avisos - name: Conta paths: /projects/{id}/domains/{domainId}: patch: tags: - Domínios summary: Trocar para onde o domínio vai description: >- `redirectTo` com outro domínio do site faz este redirecionar para ele (`308`, com o caminho); `null` faz este abrir o site direto. Para inverter o `www` (a raiz passa a levar ao `www`), mande `redirectTo: "www.loja.com.br"` na raiz: o `www`, que redirecionava para ela, passa a abrir o site no mesmo pedido, e quem apontava para a raiz passa a apontar para o `www` (nunca uma cadeia). operationId: updateDomain parameters: - $ref: '#/components/parameters/ProjectId' - $ref: '#/components/parameters/DomainId' requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/DomainUpdateInput' example: redirectTo: www.loja.com.br responses: '200': description: O domínio, com o redirecionamento novo. content: application/json: schema: type: object required: - domain properties: domain: $ref: '#/components/schemas/Domain' example: domain: id: 01JA9K3M5P7R9T1V3X5Z7B9D1F projectId: 01J8Z4B2QK7M3V9T0XW5R6N8CD hostname: loja.com.br redirectTo: www.loja.com.br 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 '401': description: Chave ausente, inválida ou revogada. content: application/json: schema: $ref: '#/components/schemas/Error' examples: invalid_api_key: summary: invalid_api_key value: status: error code: invalid_api_key message: >- Chave de API inválida ou revogada. Confira o cabeçalho "Authorization: Bearer " ou crie outra em Chaves de API no painel. '403': description: A chave é só de leitura. content: application/json: schema: $ref: '#/components/schemas/Error' examples: insufficient_permission: summary: insufficient_permission value: status: error code: insufficient_permission message: >- Esta chave é só de leitura. Para enviar, iniciar, parar, reiniciar, mexer nas variáveis, fazer e baixar backups, baixar e voltar versões dos envios, criar, ligar, desligar e ver a senha dos bancos de dados ou enviar e apagar arquivos do Blob, crie uma chave de leitura e escrita no painel. '404': description: O projeto ou o domínio não existe ou não é da sua conta. content: application/json: schema: $ref: '#/components/schemas/Error' examples: not_found: summary: not_found value: status: error code: not_found message: Domínio não encontrado. '422': description: O alvo não é outro domínio do site que abre o site direto. content: application/json: schema: $ref: '#/components/schemas/Error' examples: invalid_redirect: summary: invalid_redirect value: status: error code: invalid_redirect message: >- O redirecionamento precisa ir para outro domínio deste site que abre o site direto (sem redirecionar de novo). '429': description: Limite de pedidos. Traz o cabeçalho `Retry-After`. content: application/json: schema: $ref: '#/components/schemas/Error' examples: rate_limit_exceeded: summary: rate_limit_exceeded value: status: error code: rate_limit_exceeded message: >- A sua conta passou do limite da API do plano Free: 10 pedidos por minuto. Espere 42 s e tente de novo. too_many_attempts: summary: too_many_attempts value: status: error code: too_many_attempts message: Muitas tentativas. Tente de novo em 15 minutos. x-codeSamples: - lang: bash label: curl source: >- curl -X PATCH https://app.cubehosting.com.br/api/projects/$PROJECT_ID/domains/$DOMAIN_ID \ -H "Authorization: Bearer $CUBE_API_KEY" \ -H "Content-Type: application/json" \ -d '{"redirectTo": "www.loja.com.br"}' - lang: javascript label: Node.js source: >- const API = 'https://app.cubehosting.com.br/api'; const headers = { Authorization: `Bearer ${process.env.CUBE_API_KEY}` }; const url = `${API}/projects/${process.env.PROJECT_ID}/domains/${process.env.DOMAIN_ID}`; const res = await fetch(url, { method: 'PATCH', headers: { ...headers, 'Content-Type': 'application/json' }, body: JSON.stringify({ redirectTo: 'www.loja.com.br' }), }); console.log((await res.json()).domain.redirectTo); - lang: python label: Python source: >- import os import requests API = "https://app.cubehosting.com.br/api" headers = {"Authorization": f"Bearer {os.environ['CUBE_API_KEY']}"} url = f"{API}/projects/{os.environ['PROJECT_ID']}/domains/{os.environ['DOMAIN_ID']}" r = requests.patch(url, headers=headers, json={"redirectTo": "www.loja.com.br"}, timeout=30) r.raise_for_status() print(r.json()["domain"]["redirectTo"]) components: parameters: ProjectId: name: id in: path required: true description: >- O ID do projeto (26 caracteres). Aparece no painel, no topo do projeto, e em `GET /projects`. schema: type: string pattern: ^[0-9A-HJKMNP-TV-Z]{26}$ example: 01J8Z3W6N0Q4Y7V2K5T9D1H3XA DomainId: name: domainId in: path required: true description: >- O ID do domínio (26 caracteres), de [Listar domínios do site](/api-reference/domains/list). schema: type: string pattern: ^[0-9A-HJKMNP-TV-Z]{26}$ example: 01JA9K3M5P7R9T1V3X5Z7B9D1F schemas: DomainUpdateInput: type: object required: - redirectTo additionalProperties: false properties: redirectTo: type: - string - 'null' description: >- Outro domínio do site para redirecionar, ou `null` para abrir o site direto. Domain: type: object description: Um domínio próprio de um site. required: - id - projectId - hostname - redirectTo - status - error - records - verifiedAt - checkedAt - createdAt - project properties: id: type: string description: ID do domínio (26 caracteres). projectId: type: string description: O site que o domínio abre. hostname: type: string description: >- O domínio, em minúsculas (acento em punycode: `café.com.br` → `xn--caf-dma.com.br`). redirectTo: type: - string - 'null' description: >- Outro domínio do site para onde este redireciona (`308`, com o caminho); `null` = abre o site. status: type: string enum: - pending - active - error description: >- `pending`: falta o TXT ou o CNAME (verificando). `active`: verificado e chegando à Cube. `error`: veja `error`. error: oneOf: - type: object required: - code - message properties: code: type: string enum: - verification_expired - domain_taken - certificate_failed - plan_not_allowed message: type: string - type: 'null' description: >- `verification_expired`: sem o TXT em 7 dias. `domain_taken`: outra conta provou a posse antes. `certificate_failed`: o HTTPS não saiu. `plan_not_allowed`: o plano de agora não tem domínio próprio. records: type: array items: $ref: '#/components/schemas/DomainRecord' description: Os dois registros para criar no DNS do domínio. verifiedAt: type: - string - 'null' format: date-time description: Quando a posse foi provada; `null` até achar o TXT. checkedAt: type: - string - 'null' format: date-time description: A última conferência. createdAt: type: string format: date-time project: type: object required: - id - name properties: id: type: string name: type: string Error: type: object required: - status - code - message properties: status: type: string const: error code: type: string description: Código fixo em inglês. Veja [Códigos de erro](/errors). message: type: string description: Texto em português para mostrar a uma pessoa. additionalProperties: true DomainRecord: type: object required: - type - name - value - isOk properties: type: type: string enum: - CNAME - TXT name: type: string description: >- O nome do registro. O TXT fica em `_cube-verify.`: o `www` e a raiz usam o mesmo. value: type: string description: >- O valor: `domains.cubehost.dev` no CNAME; `cube-verify=` no TXT. isOk: type: boolean description: Se a Cube já achou o registro certo. securitySchemes: bearerAuth: type: http scheme: bearer description: >- Chave de API da Cube (`cube_…`), criada no painel em **Chaves de API**. Mande como `Authorization: Bearer cube_…`. ````