Atelier201 websiteJoin the waitlist
Using the productSolução de problemas
Using the product

Solução de problemas

O que verificar quando uma compilação falha, uma alteração não é publicada, um domínio continua pendente ou uma solicitação é recusada.

Uma compilação falhou

Abra a compilação: error mostra um código e uma mensagem, e o registro exibe a saída do compilador (as mensagens do Astro). As causas mais comuns:

  • Um valor de conteúdo que não corresponde ao esquema. O registro indica o campo. Corrija o conteúdo, não o esquema, a menos que você queira adicionar um novo tipo de dado.
  • Uma dependência que não está disponível para a compilação. A compilação é executada sem acesso à rede, usando os pacotes disponíveis no Atelier201, então projetos que adicionam outro pacote ou outra versão são recusados. dependencies_unavailable significa isso, e a mensagem informa o nome do pacote.
  • Infraestrutura. build_infrastructure indica uma falha no contêiner de compilação ou no armazenamento, não nos seus arquivos. Execute a compilação novamente.

Uma compilação pronta da mesma revisão é reutilizada. Portanto, execute a compilação novamente depois de corrigir o problema, não antes.

Publiquei, mas os visitantes ainda veem o site antigo

A publicação chega a todos os endereços em cerca de um minuto. Se a versão antiga continuar aparecendo depois disso, confira se você publicou a compilação desejada: atelier201 publish history e o published.build_id do site mostram o que está no ar. Publicar novamente ou reverter uma publicação reescreve o roteamento do site.

A publicação foi recusada

Mensagem ou códigoCausa
409 conflict após uma revisãoAlguém publicou desde a sua revisão. Revise novamente e envie o novo expected_generation.
409 conflict ao listar bloqueiosA compilação não pode ser publicada. Cada bloqueio informa o que fazer: consulte Como um site é publicado.
403 insufficient_scopeA credencial não tem sites:publish. Peça ao proprietário para publicar ou reconecte com esse escopo.
403 admin_requiredSomente um administrador do espaço de trabalho pode publicar.

Uma alteração foi recusada por conflito

Você editou um arquivo que alguém alterou desde que você o leu. O details do erro contém a revisão atual e os caminhos. Leia esses arquivos novamente e aplique sua alteração sobre a versão atual.

Um domínio continua pendente

Um domínio passa de pending_ownership para provisioning e depois para active quando seus registros estão configurados. Se continuar em pending_ownership, o registro TXT está faltando ou ainda não se propagou. Compare-o com os registros no app, aguarde e verifique o domínio novamente. Um conflito com uma mensagem sobre o plano significa que o site não tem mais domínios personalizados disponíveis: remova um ou passe o site para um plano superior.

Um limite do plano foi atingido

A publicação de um rascunho é recusada com 403 feature_not_available; criar um rascunho além do limite de rascunhos do espaço de trabalho e conectar um domínio a um rascunho são recusados com 409 conflict. Cada mensagem indica o limite e inclui um link para a página que permite aumentá-lo (action_url). Passe o site para o plano Site ou exclua um rascunho e tente novamente. Um agente não deve repetir a tentativa em loop nem alterar o plano por conta própria.

Meu saldo de créditos parece incorreto

O saldo corresponde à soma dos créditos concedidos que ainda não expiraram, menos os créditos utilizados. A página Cobrança lista cada crédito concedido e sua data de expiração. Somente recursos de IA consomem créditos: o assistente e as imagens ou os vídeos criados com IA.

Não consigo entrar

Confira qual endereço de e-mail está associado à conta. Uma conta criada com o Google e outra criada com uma senha só são a mesma conta se usarem o mesmo endereço.

Use these docs with your AI tools

An AI agent can read this documentation directly. You do not need an account or an API key. Everything here is public and read-only.

Query these docs via MCP

Recommended

Add this server to Claude, Claude Code, Cursor, Mistral, or any tool that supports MCP. Your agent can then search Atelier201 Docs documentation and read it in full, instead of answering from memory.

https://atelier201.com/docs/mcp
  • searchFind the passages that answer a question.
  • fetchRead one page in full, as Markdown.
  • list_pagesSee every page in this documentation.

Query these docs over HTTP

The same tools also work as plain web requests. Use this for scripts, or for any tool that does not support MCP. There is one endpoint per tool. Arguments go in the query string, and the answer comes back as JSON.

https://atelier201.com/docs/api/docs/search?query=custom+domain

Read the OpenAPI description. It is built from the same definitions as the tools, so it always matches what the endpoints do.

Read these docs as Markdown

Add .md to any page URL to get its Markdown source. You can also send the headerAccept: text/markdown to the page URL itself.

To read the whole documentation in one file, open llms-full.txt. For a short index of every page, open llms.txt.