Modifier une application

Exécute la même modification que lorsque vous écrivez une instruction dans l’éditeur de Setherion. C’est la même route que celle du champ de l’éditeur : les mêmes crédits, les mêmes règles de forfait et les mêmes contrôles de sécurité s’appliquent, et le résultat est enregistré et ajouté à l’historique de l’application comme n’importe quelle autre modification.

Vous devez pouvoir modifier l’application : elle est à vous, vous êtes éditeur ou administrateur de son espace de travail, ou elle a été partagée avec vous en tant qu’éditeur.

Les crédits sont prélevés sur le compte qui paie l’application, c’est-à-dire son créateur, pas nécessairement vous. Si l’espace de travail de l’application limite ce que vous pouvez dépenser, cette limite s’applique aussi.

Requête

curl -X POST https://www.setherion.com/api/v1/projects/7c1e4a52-9b0d-4f3e-8a61-2d5f0c9e7b14/edit \
  -H "Authorization: Bearer $SETHERION_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "prompt": "Make the buttons green and add an opening hours section" }'

L’application doit déjà avoir du code. Une application qui n’a jamais été construite répond 409.

Elle répond quand la modification est terminée

Une modification prend de une à plusieurs minutes, et la requête reste ouverte jusqu’à ce qu’elle soit terminée. Une modification qui dépasse environ 13 minutes est coupée par le serveur.

Pendant le travail, Setherion envoie une espace toutes les 10 secondes, pour que rien entre vous et nous ne ferme une connexion silencieuse. Des espaces avant le JSON restent du JSON valide : lisez le corps en entier, puis analysez-le.

Dès que la modification a commencé, le statut est 200 quoi qu’il arrive, et ok dit comment cela s’est passé. L’en-tête X-Setherion-Run de la réponse porte le runId de la modification dès le premier instant, avant le corps.

Réponse

Une modification terminée :

{
  "ok": true,
  "runId": "b3f0e2d1-6a47-4c8e-9d15-0f2b7a3c8e61",
  "projectId": "7c1e4a52-9b0d-4f3e-8a61-2d5f0c9e7b14",
  "changed": {
    "added": ["src/components/OpeningHours.tsx"],
    "modified": ["src/App.tsx", "src/index.css"],
    "removed": []
  }
}

Une modification qui a cassé la construction de l’application :

{
  "ok": true,
  "runId": "b3f0e2d1-6a47-4c8e-9d15-0f2b7a3c8e61",
  "projectId": "7c1e4a52-9b0d-4f3e-8a61-2d5f0c9e7b14",
  "changed": { "added": [], "modified": ["src/App.tsx"], "removed": [] },
  "builds": false,
  "refundedCredits": 10
}

Une modification qui n’a pas eu lieu :

{ "ok": false, "error": "This edit costs 10 credits and you have 3.", "outOfCredits": true }

outOfCredits est présent, et à true, seulement quand le compte qui paie la modification n’a plus de crédits. Tout autre refus a ok: false et un error, et rien d’autre.

Suivre une modification

Où en est une modification, pour un client qui a cessé d’attendre ou n’a jamais attendu. Gratuit, et sans risque à demander toutes les minutes environ.

curl "https://www.setherion.com/api/v1/projects/7c1e4a52-9b0d-4f3e-8a61-2d5f0c9e7b14/edit?run=b3f0e2d1-6a47-4c8e-9d15-0f2b7a3c8e61" \
  -H "Authorization: Bearer $SETHERION_API_KEY"

{
  "ok": true,
  "status": "done",
  "runId": "b3f0e2d1-6a47-4c8e-9d15-0f2b7a3c8e61",
  "projectId": "7c1e4a52-9b0d-4f3e-8a61-2d5f0c9e7b14",
  "startedAt": "2026-10-16T15:13:02.118Z"
}

Une réponse à false porte aussi une phrase error, et la modification peut être renvoyée. Cette réponse ne liste pas les fichiers qui ont changé : seule la réponse de la modification elle-même le fait.

Erreurs avant le début de la modification