guest

Prepare a site before sign-in

For an agent working for someone who has no account yet. Creates a site from the starter and returns a write token (2 hours: import files and build, 3 builds) and a private claim URL (7 days) the person opens to make the site theirs. The demo it produces is served sandboxed, never indexed, and cannot be published or put on a domain before the claim. No credits, no AI.

POST/v1/guest/sites

Request

curl --request POST \
  --url 'https://api.atelier201.com/v1/guest/sites' \
  --header 'Content-Type: application/json' \
  --data '{
  "name": "<string>"
}'

import json
import requests

url = "https://api.atelier201.com/v1/guest/sites"
headers = {
  "Content-Type": "application/json"
}
payload = json.loads("{\"name\":\"<string>\"}")

response = requests.request("POST", url, headers=headers, json=payload)
print(response.json())

const response = await fetch("https://api.atelier201.com/v1/guest/sites", {
  method: "POST",
  headers: {
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "name": "<string>"
  }),
});

const data = await response.json();
console.log(data);

<?php
$client = curl_init();

curl_setopt($client, CURLOPT_URL, "https://api.atelier201.com/v1/guest/sites");
curl_setopt($client, CURLOPT_CUSTOMREQUEST, "POST");
curl_setopt($client, CURLOPT_HTTPHEADER, [
    "Content-Type: application/json",
]);
curl_setopt($client, CURLOPT_POSTFIELDS, "{\"name\":\"<string>\"}");
curl_setopt($client, CURLOPT_RETURNTRANSFER, true);

$response = curl_exec($client);
curl_close($client);
echo $response;

package main

import (
  "bytes"
  "fmt"
  "io"
  "net/http"
)

func main() {
  req, _ := http.NewRequest("POST", "https://api.atelier201.com/v1/guest/sites", bytes.NewBuffer([]byte("{\"name\":\"<string>\"}")))
  req.Header.Set("Content-Type", "application/json")
  res, _ := http.DefaultClient.Do(req)
  defer res.Body.Close()
  data, _ := io.ReadAll(res.Body)
  fmt.Println(string(data))
}

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

var request = HttpRequest.newBuilder(URI.create("https://api.atelier201.com/v1/guest/sites"))
    .header("Content-Type", "application/json")
    .method("POST", HttpRequest.BodyPublishers.ofString("{\"name\":\"<string>\"}"))
    .build();

var response = HttpClient.newHttpClient().send(
    request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());

require 'net/http'
require 'json'

uri = URI("https://api.atelier201.com/v1/guest/sites")
request = Net::HTTP::Post.new(uri)
request["Content-Type"] = "application/json"
request.body = "{\"name\":\"<string>\"}"

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: uri.scheme == "https") do |http|
  http.request(request)
end

puts response.body

application/json

{
  "data": {
    "site_id": "<string>",
    "address": "<string>",
    "write_token": "<string>",
    "write_expires_at": "<string>",
    "claim_url": "<string>",
    "claim_expires_at": "<string>",
    "next_action": "<string>"
  },
  "request_id": "<string>"
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "docs_url": "<string>",
    "action_url": "<string>",
    "details": {}
  },
  "request_id": "<string>"
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "docs_url": "<string>",
    "action_url": "<string>",
    "details": {}
  },
  "request_id": "<string>"
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "docs_url": "<string>",
    "action_url": "<string>",
    "details": {}
  },
  "request_id": "<string>"
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "docs_url": "<string>",
    "action_url": "<string>",
    "details": {}
  },
  "request_id": "<string>"
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "docs_url": "<string>",
    "action_url": "<string>",
    "details": {}
  },
  "request_id": "<string>"
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "docs_url": "<string>",
    "action_url": "<string>",
    "details": {}
  },
  "request_id": "<string>"
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "docs_url": "<string>",
    "action_url": "<string>",
    "details": {}
  },
  "request_id": "<string>"
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "docs_url": "<string>",
    "action_url": "<string>",
    "details": {}
  },
  "request_id": "<string>"
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "docs_url": "<string>",
    "action_url": "<string>",
    "details": {}
  },
  "request_id": "<string>"
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "docs_url": "<string>",
    "action_url": "<string>",
    "details": {}
  },
  "request_id": "<string>"
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "docs_url": "<string>",
    "action_url": "<string>",
    "details": {}
  },
  "request_id": "<string>"
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "docs_url": "<string>",
    "action_url": "<string>",
    "details": {}
  },
  "request_id": "<string>"
}

No bearer credential. The caller is anonymous and rate limited by address.

The reply holds write_token (2 hours), claim_url (7 days) and next_action. Pass device_code and client_id from an OAuth device request if you want the person to be able to connect the agent when they claim the site. Read the agent instructions for the complete flow.

Nothing can be published, no domain connected and no credit spent, and no model is called. Keep the write token and the claim link private: see Guest sites. On refusal, offer the ordinary sign-up. Do not retry with new identities.

Body

application/jsonrequired

namestringrequiredlength: 1–80 chars

slugstringlength: 3–40 chars

device_codestringlength: 8–200 chars

From POST /oauth/device_authorization, to let the person connect this agent when they claim the site.

client_idstringlength: 1–512 chars

Response

application/json

Prepare a site before sign-in

dataobjectrequired

Show child attributes

data.site_idstringrequired

data.addressstringrequired

data.write_tokenstringrequired

Authorization: Guest <write_token> on import, builds and status. Valid 2 hours. Keep it out of logs and chats.

data.write_expires_atstringrequired

data.claim_urlstringrequired

Give this to the person: they sign in and the site becomes theirs. Valid 7 days.

data.claim_expires_atstringrequired

data.next_actionstringrequired

request_idstringrequired

{ "data": { "site_id": "<string>", "address": "<string>", "write_token": "<string>", "write_expires_at": "<string>", "claim_url": "<string>", "claim_expires_at": "<string>", "next_action": "<string>" }, "request_id": "<string>" }

{ "error": { "type": "<string>", "code": "<string>", "message": "<string>", "param": "<string>", "docs_url": "<string>", "action_url": "<string>", "details": {} }, "request_id": "<string>" }

Prepare a site before sign-in

Body

Response

Use these docs with your AI tools

Query these docs via MCP

Query these docs over HTTP

Read these docs as Markdown

Cookies