sites

Confirmar los cambios del espacio de trabajo

Guarda todos los cambios sin confirmar del espacio de trabajo como UNA entrada del historial, tras pasar el control de confirmación (sin secretos, sin .env, sin código del servidor y con JSON válido). Si no hay nada que confirmar: changed es false.

POST/v1/sites/{site_id}/workspace:commit

Request

curl --request POST \
  --url 'https://api.atelier201.com/v1/sites/<site_id>/workspace:commit' \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '{
  "summary": "<string>"
}'

import json
import requests

url = "https://api.atelier201.com/v1/sites/<site_id>/workspace:commit"
headers = {
  "Authorization": "<api-key>",
  "Content-Type": "application/json"
}
payload = json.loads("{\"summary\":\"<string>\"}")

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

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

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>/workspace:commit");
curl_setopt($client, CURLOPT_CUSTOMREQUEST, "POST");
curl_setopt($client, CURLOPT_HTTPHEADER, [
    "Authorization: <api-key>",
    "Content-Type: application/json",
]);
curl_setopt($client, CURLOPT_POSTFIELDS, "{\"summary\":\"<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/sites/<site_id>/workspace:commit", bytes.NewBuffer([]byte("{\"summary\":\"<string>\"}")))
  req.Header.Set("Authorization", "<api-key>")
  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/sites/<site_id>/workspace:commit"))
    .header("Authorization", "<api-key>")
    .header("Content-Type", "application/json")
    .method("POST", HttpRequest.BodyPublishers.ofString("{\"summary\":\"<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/sites/<site_id>/workspace:commit")
request = Net::HTTP::Post.new(uri)
request["Authorization"] = "<api-key>"
request["Content-Type"] = "application/json"
request.body = "{\"summary\":\"<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": {
    "revision": "<string>",
    "parent": "<string>",
    "changed": true,
    "changes": [
      {
        "path": "<string>",
        "action": "<string>"
      }
    ],
    "note": null,
    "build": {
      "id": "<string>",
      "state": "<string>",
      "next_action": "<string>"
    },
    "not_committed": [
      "<string>"
    ],
    "warning": "<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>"
}

Requiere sites:write. No cuesta créditos. La ruta termina en /workspace:commit. Solo modifica el borrador. Los visitantes no verán nada hasta que publiques.

Todos los cambios sin confirmar del espacio de trabajo se guardan en una sola entrada del historial, independientemente del número de archivos. summary es obligatorio y admite un máximo de 500 caracteres: una frase que explique qué hace el cambio, que es lo que se muestra en el historial.

Se aplica la misma protección de confirmaciones que al resto de los cambios. Si se detecta un secreto, un archivo .env, código de servidor o JSON no válido, la solicitud se rechaza con 400 y el motivo, y no se guarda nada. Corrige el archivo en el espacio de trabajo y vuelve a confirmar los cambios. Se muestran todos los problemas a la vez, con el archivo y la línea correspondientes.

Los archivos incluidos en el .gitignore del proyecto (por ejemplo, un .env.local o un archivo de claves) nunca forman parte de una confirmación, así que tampoco se rechazan: se excluyen. Si uno de esos archivos parece contener un secreto, la respuesta lo indica en not_committed con una warning: no se ha guardado, nunca llegará al sitio y desaparecerá al reiniciar el espacio de trabajo.

Si no hay cambios sin confirmar, la llamada se completa con changed: false y no se crea ninguna entrada. En caso contrario, revision identifica la nueva entrada, parent la anterior y changes las rutas modificadas. Si entretanto se ha aplicado otro cambio al borrador, se conservan tus ediciones y se indica en note.

A continuación, inicia una compilación para verla en una vista previa.

Autorizaciones

Authorizationbearerin headerrequired

Parámetros de ruta

site_idstringrequired

El ID del sitio o su slug (la dirección antes de .atelier201.page).

Cuerpo

application/jsonrequired

summarystringrequiredlength: 1–500 chars

Qué hace el cambio, en una frase: la entrada del historial que leen los usuarios.

Respuesta

application/json

Confirma los cambios del espacio de trabajo

dataobjectrequired

Show child attributes

data.revisionstringrequiredlength: 40–40 chars

Un ID de commit de Git (40 caracteres hexadecimales) del repositorio del sitio.

data.parentstring | nullrequired

data.changedbooleanrequired

data.changesobject[]required

Show child attributes

data.changes.pathstringrequired

data.changes.actionstringrequired

data.notestringnullrequired

data.buildobject | nullrequired

La compilación que inició este cambio (o a la que se incorporó): la vista previa la sigue. No hace falta llamar a build_site.

Show child attributes

data.build.idstringrequired

data.build.statestringrequired

data.build.next_actionstringrequired

data.not_committedstring[]

Los archivos que parecen contener secretos (.env.local, un archivo de clave) y que el .gitignore del proyecto excluye de todas las confirmaciones: nunca se guardan ni se hacen públicos.

data.warningstring

Qué significa not_committed, en una frase.

request_idstringrequired

curl --request POST \ --url 'https://api.atelier201.com/v1/sites/<site_id>/workspace:commit' \ --header 'Authorization: <api-key>' \ --header 'Content-Type: application/json' \ --data '{ "summary": "<string>" }'

{ "data": { "revision": "<string>", "parent": "<string>", "changed": true, "changes": [ { "path": "<string>", "action": "<string>" } ], "note": null, "build": { "id": "<string>", "state": "<string>", "next_action": "<string>" }, "not_committed": [ "<string>" ], "warning": "<string>" }, "request_id": "<string>" }

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

Confirmar los cambios del espacio de trabajo

Autorizaciones

Parámetros de ruta

Cuerpo

Respuesta

Use these docs with your AI tools

Query these docs via MCP

Query these docs over HTTP

Read these docs as Markdown

Cookies