---
title: "API-Übersicht"
description: "Was die REST API leistet, wo sie zu finden ist und wie du damit einen Standort erstellst, bearbeitest und veröffentlichst."
canonical: "https://atelier201.com/docs/de/api/overview"
updated: "2026-11-06"
---

# API-Übersicht

Die API ist unter `https://api.atelier201.com/v1` erreichbar. Sie bietet alle Funktionen der App. Auch die [CLI](/docs/cli/overview) und der [MCP-Server](/docs/mcp/overview) verwenden denselben Vertrag.

## Dein erster Aufruf

```bash
curl https://api.atelier201.com/v1/account \
  -H "Authorization: Bearer $ATELIER201_API_KEY"
```

**Rufe zuerst `/v1/account` auf.** Eine Anfrage zeigt dir den Workspace, den Tarif und genau, welche Berechtigungen für deine Zugangsdaten erteilt wurden. Diese Informationen einzeln durch 403-Fehler herauszufinden, dauert länger.

## Von null zum veröffentlichten Standort

Jeder Schritt erfordert einen Aufruf. Nur der letzte ändert, was Besucher sehen.

1. [Standort erstellen](/docs/api/sites/create). Er basiert auf dem Atelier201-Starter und wird einmal erstellt.
2. [Das Inhaltsmodell lesen](/docs/api/content/model), dann Texte und Einträge mit [Einen Eintrag erstellen oder aktualisieren](/docs/api/content/save-entry) und [Ein einzelnes Feld ändern](/docs/api/content/set-field) bearbeiten.
3. [Standort erstellen](/docs/api/builds/start) und den Status von [Build abrufen](/docs/api/builds/retrieve) regelmäßig abfragen, bis er `ready` ist.
4. [Vorschau teilen](/docs/api/previews/create) und dem Betreiber zeigen.
5. [Prüfen](/docs/api/publishing/review), dann nach der Freigabe durch den Betreiber [veröffentlichen](/docs/api/publishing/publish).

Die Hintergründe zu den einzelnen Schritten findest du unter [So geht ein Standort live](/docs/platform/drafts-builds-and-publishing).

## Kosten

Bearbeiten, Erstellen, Vorschau und Veröffentlichen sind im Tarif des Standorts enthalten und kosten keine Credits. Eine Ausnahme gibt es: [Bilder oder Videos mit AI erstellen](/docs/api/media/generate). Dieser Endpunkt hat einen festen Preis, den du zuerst kostenlos testen kannst, und erfordert die separate Berechtigung `media:generate`. Weitere Informationen unter [Tarife und Credits](/docs/platform/credits-and-plans).

## Was die API nicht kann

Sie ist keine Streaming-API und hält keine Verbindung offen. Beim Starten eines Builds erhältst du sofort einen Build mit dem Status `queued`. Anschließend fragst du den Status ab. Der Build läuft auch weiter, wenn die Verbindung deines Clients getrennt wird.