Atelier201 websiteJoin the waitlist
Using the productSolución de problemas
Using the product

Solución de problemas

Qué comprobar si falla una compilación, un cambio no se publica, un dominio sigue pendiente o se rechaza una solicitud.

Ha fallado una compilación

Abre la compilación: error muestra un código y un mensaje, y el registro incluye la salida del compilador (los mensajes de Astro). Estas son las causas más habituales:

  • Un valor de contenido que no coincide con su esquema. El registro indica el campo. Corrige el contenido, no el esquema, salvo que quieras añadir un nuevo tipo de datos.
  • Una dependencia que la compilación no tiene. La compilación se ejecuta sin acceso a la red y solo con los paquetes disponibles en Atelier201, por lo que se rechaza cualquier proyecto que añada otro paquete u otra versión. dependencies_unavailable indica este problema y el mensaje especifica el paquete.
  • La infraestructura. build_infrastructure indica que ha fallado el contenedor de compilación o el almacenamiento, no tus archivos. Vuelve a compilar.

Se reutiliza una compilación correcta de la misma revisión, así que vuelve a compilar después de corregir el problema, no antes.

He publicado y los visitantes siguen viendo el sitio antiguo

La publicación llega a todas las direcciones en aproximadamente un minuto. Si después de ese tiempo sigue apareciendo la versión antigua, comprueba que hayas publicado la compilación que querías: atelier201 publish history y el published.build_id del sitio indican qué versión está publicada. Si vuelves a publicar o haces una reversión, se actualiza el enrutamiento del sitio.

Se rechaza la publicación

Mensaje o códigoCausa
409 conflict después de una revisiónAlguien ha publicado desde que revisaste. Vuelve a revisar y envía el nuevo expected_generation.
409 conflict al mostrar los bloqueosLa compilación no se puede publicar. Cada bloqueo indica qué hacer: consulta Cómo se publica un sitio.
403 insufficient_scopeLa credencial no tiene sites:publish. Pide al propietario que publique o vuelve a conectarte con ese ámbito.
403 admin_requiredSolo un administrador del espacio de trabajo puede publicar.

Se ha rechazado un cambio por un conflicto

Has escrito en un archivo que alguien modificó desde que lo leíste. details del error contiene la revisión actual y las rutas. Vuelve a leer esos archivos y aplica el cambio sobre la versión actual.

Un dominio sigue pendiente

Un dominio pasa de pending_ownership a provisioning y después a active cuando sus registros están configurados. Si permanece en pending_ownership, falta el registro TXT o aún no se ha propagado. Compáralo con los registros de la aplicación, espera y vuelve a comprobar el dominio. Si un conflicto muestra un mensaje sobre el plan, significa que el sitio ya no puede tener más dominios personalizados: elimina uno o cambia el sitio a un plan superior.

Se ha alcanzado el límite del plan

Se rechaza la publicación de un borrador con 403 feature_not_available. También se rechaza crear un borrador que supere el límite del espacio de trabajo o conectar un dominio a un borrador, en ambos casos con 409 conflict. Cada mensaje indica el límite y enlaza a la página para ampliarlo (action_url). Cambia el sitio al plan Site o elimina un borrador y vuelve a intentarlo. Un agente no debe repetir el intento en bucle ni cambiar el plan por su cuenta.

El saldo de créditos no parece correcto

El saldo es la suma de los créditos concedidos que no han caducado, menos los que se han utilizado. En la página Facturación se muestran todas las concesiones y sus fechas de caducidad. Solo las funciones de IA consumen créditos: el asistente y las imágenes o vídeos generados con IA.

No puedo iniciar sesión

Comprueba qué dirección de correo electrónico utiliza la cuenta. Una cuenta creada con Google y otra creada con contraseña solo son la misma cuenta si comparten la dirección.

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.