Atelier201 websiteJoin the waitlist
Using the productFehlerbehebung
Using the product

Fehlerbehebung

Was du überprüfen solltest, wenn ein Build fehlschlägt, eine Änderung nicht live ist, eine Domain aussteht oder ein Aufruf abgelehnt wird.

Ein Build ist fehlgeschlagen

Öffne den Build: error enthält einen Code und eine Meldung, und das Protokoll zeigt die Ausgabe des Compilers (die Meldungen von Astro). Häufige Ursachen:

  • Ein Inhaltswert entspricht nicht dem Schema. Im Protokoll wird das Feld genannt. Korrigiere den Inhalt, nicht das Schema, es sei denn, du wolltest eine neue Datenart hinzufügen.
  • Eine Abhängigkeit, die im Build nicht verfügbar ist. Der Build läuft ohne Netzwerkzugriff und mit den Paketen, die Atelier201 bereitstellt. Daher wird ein Projekt abgelehnt, das ein weiteres Paket oder eine andere Version hinzufügt. dependencies_unavailable bedeutet genau das; in der Meldung wird das Paket genannt.
  • Infrastruktur. build_infrastructure bedeutet, dass der Build-Container oder der Speicher ausgefallen ist, nicht deine Dateien. Starte den Build erneut.

Ein erfolgreicher Build derselben Revision wird wiederverwendet. Starte den Build also nach einer Korrektur erneut, nicht vorher.

Ich habe veröffentlicht, aber Besucher sehen weiterhin die alte Website

Eine Veröffentlichung erreicht innerhalb von etwa einer Minute alle Adressen. Wenn danach weiterhin die alte Version angezeigt wird, prüfe, ob du den gewünschten Build veröffentlicht hast: atelier201 publish history und die published.build_id der Website zeigen an, was live ist. Erneutes Veröffentlichen oder ein Rollback schreibt das Routing der Website neu.

Veröffentlichung abgelehnt

Meldung oder CodeUrsache
409 conflict nach einer ÜberprüfungSeit deiner Überprüfung hat jemand veröffentlicht. Überprüfe erneut und sende den neuen Wert für expected_generation.
409 conflict mit einer Liste von BlockernDer Build kann nicht live geschaltet werden. Jeder Blocker nennt die erforderliche Maßnahme: siehe So geht eine Website live.
403 insufficient_scopeDie Berechtigung umfasst nicht sites:publish. Bitte den Inhaber, zu veröffentlichen, oder verbinde dich erneut mit diesem Berechtigungsumfang.
403 admin_requiredNur ein Workspace-Admin kann veröffentlichen.

Eine Änderung wurde wegen eines Konflikts abgelehnt

Du hast eine Datei bearbeitet, die jemand geändert hat, seit du sie gelesen hast. In details der Fehlermeldung stehen die aktuelle Revision und die Pfade. Lies diese Dateien erneut und wende deine Änderung darauf an.

Eine Domain bleibt ausstehend

Eine Domain wechselt von pending_ownership über provisioning zu active, sobald ihre Einträge vorhanden sind. Bleibt sie bei pending_ownership, fehlt der TXT-Eintrag oder die Änderung hat sich noch nicht verbreitet. Vergleiche ihn mit den Einträgen in der App, warte und prüfe die Domain erneut. Ein Konflikt mit einer Meldung zum Tarif bedeutet, dass für die Website keine benutzerdefinierte Domain mehr verfügbar ist: Entferne eine Domain oder wechsle mit der Website zu einem höheren Tarif.

Ein Tariflimit wurde erreicht

Die Veröffentlichung eines Entwurfs wird mit 403 feature_not_available abgelehnt. Das Erstellen eines Entwurfs über das Entwurfslimit des Workspace hinaus und das Verbinden einer Domain mit einem Entwurf werden mit 409 conflict abgelehnt. In jedem Fall werden das Limit genannt und ein Link zu der Seite angegeben, auf der es aufgehoben werden kann (action_url). Wechsle für die Website zum Site-Tarif oder lösche einen Entwurf und versuche es dann erneut. Ein Agent darf nicht in einer Schleife erneut versuchen oder den Tarif selbst ändern.

Mein Guthaben scheint nicht zu stimmen

Das Guthaben ergibt sich aus der Summe der noch gültigen Gutschriften abzüglich des bereits verbrauchten Betrags. Auf der Seite Abrechnung sind alle Gutschriften mit ihrem Ablaufdatum aufgeführt. Nur KI-Funktionen verbrauchen Guthaben: der Assistent sowie mit KI erstellte Bilder und Videos.

Ich kann mich nicht anmelden

Prüfe, welche E-Mail-Adresse für das Konto verwendet wird. Ein mit Google erstelltes Konto und ein mit einem Passwort erstelltes Konto sind nur dann dasselbe Konto, wenn sie dieselbe Adresse verwenden.

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.