API overview
What the REST API does, where it lives, and how to create, change and publish a site with it.
The API is at https://api.atelier201.com/v1. It can do everything the app can,
and the CLI and the MCP server use
the same contract.
Your first call
curl https://api.atelier201.com/v1/account \
-H "Authorization: Bearer $ATELIER201_API_KEY"Call /v1/account first. One request tells you the workspace, the plan and
precisely which scopes the credential you hold was granted. Discovering those
one 403 at a time is the slow way.
From nothing to a live site
Each step is one call. Only the last one changes what visitors see.
- Create a site. It starts from the Atelier201 starter and builds once.
- Read the content model, then change texts and entries with Create or update an entry and Change one field.
- Build the site and poll
the build until it is
ready. - Share a preview and show it to the owner.
- Review, then publish after the owner approves.
The concepts behind each step are in How a site goes live.
Costs
Editing, building, previewing and publishing are part of the site’s plan and
spend no credits. One endpoint does: making an image or video with
AI, at a fixed price you get first for free, behind its
own media:generate permission. See Plans and credits.
What it does not do
It is not a streaming API and it does not hold a connection open. Starting a
build returns at once with a queued build, and you poll for the result. A build
survives your client disconnecting.