sites

Eine Website löschen

Setzt die Website jetzt unter allen Adressen offline und löscht innerhalb weniger Minuten ihr Repository, ihre Builds und Medien. Kann nicht rückgängig gemacht werden: Exportiere die Website vorher, falls du sie später noch brauchst. Erfordert sites:publish und eine Workspace-Adminrolle. Mit confirm_name (dem Namen oder Slug der Website) wird der Aufruf abgelehnt, wenn der Wert nicht übereinstimmt. Eine veröffentlichte Website wird abgelehnt, sofern delete_published nicht true ist. CLI und Agents senden diesen Wert immer mit.

DELETE/v1/sites/{site_id}

Request

curl --request DELETE \
  --url 'https://api.atelier201.com/v1/sites/<site_id>' \
  --header 'Authorization: <api-key>'

import json
import requests

url = "https://api.atelier201.com/v1/sites/<site_id>"
headers = {
  "Authorization": "<api-key>"
}

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

const response = await fetch("https://api.atelier201.com/v1/sites/<site_id>", {
  method: "DELETE",
  headers: {
    "Authorization": "<api-key>"
  },
});

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

<?php
$client = curl_init();

curl_setopt($client, CURLOPT_URL, "https://api.atelier201.com/v1/sites/<site_id>");
curl_setopt($client, CURLOPT_CUSTOMREQUEST, "DELETE");
curl_setopt($client, CURLOPT_HTTPHEADER, [
    "Authorization: <api-key>",
]);
curl_setopt($client, CURLOPT_RETURNTRANSFER, true);

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

package main

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

func main() {
  req, _ := http.NewRequest("DELETE", "https://api.atelier201.com/v1/sites/<site_id>", nil)
  req.Header.Set("Authorization", "<api-key>")
  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/sites/<site_id>"))
    .header("Authorization", "<api-key>")
    .method("DELETE", HttpRequest.BodyPublishers.noBody())
    .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/sites/<site_id>")
request = Net::HTTP::Delete.new(uri)
request["Authorization"] = "<api-key>"

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": {
    "id": "<string>",
    "deleting": true,
    "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>"
}

Erfordert sites:publish und Administratorrechte für den Workspace. Die Anfrage wird mit 202 beantwortet. Der Löschvorgang ist innerhalb weniger Minuten abgeschlossen.

Dieser Vorgang kann nicht rückgängig gemacht werden. Exportieren Sie das Projekt, falls Sie es möglicherweise noch benötigen.

Übergeben Sie confirm_name mit dem Namen oder Slug der Website, damit der Server prüft, ob Sie die richtige Website meinen. Ein abweichender Wert wird mit invalid_parameter abgelehnt. Bei gesetztem confirm_name wird eine veröffentlichte Website mit 409 conflict (details.reason site_published) abgelehnt, sofern delete_published nicht auf true gesetzt ist. Heben Sie die Veröffentlichung zuerst auf oder bestätigen Sie ausdrücklich, dass Sie die Website löschen möchten. Die CLI und das MCP-Tool delete_site senden immer beide Bestätigungen.

Autorisierung

Authorizationbearerin headerrequired

Pfadparameter

site_idstringrequired

ID der Website oder ihr Slug (die Adresse vor .atelier201.page).

Query-Parameter

confirm_namestringlength: 1–200 chars

Der Name oder Slug der Website, den du zur Bestätigung erneut eingibst: Damit wird sichergestellt, dass du die richtige Website meinst. Das Löschen kann nicht rückgängig gemacht werden.

delete_publishedboolean

Erforderlich und auf true zu setzen, um eine veröffentlichte Website zu löschen: Sie wird sofort für alle Besucher offline genommen. Andernfalls musst du sie zuerst die Veröffentlichung aufheben.

Antwort

application/json

Website löschen

dataobjectrequired

Show child attributes

data.idstringrequired

data.deletingbooleanrequired

data.next_actionstring

request_idstringrequired

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

Eine Website löschen

Autorisierung

Pfadparameter

Query-Parameter

Antwort

Use these docs with your AI tools

Query these docs via MCP

Query these docs over HTTP

Read these docs as Markdown

Cookies