Publish an app

Puts the app online exactly as it is saved, through the same steps as the Publish button in the editor. An app that was published before keeps its address; one published for the first time gets an address made from its name, on setherion.app.

Publishing does not use credits. You need to be able to edit the app. It is limited to 100 publishes per account per day through the API, which no one working by hand reaches; the editor's own button has no such limit.

Request

No body is needed.

curl -X POST https://www.setherion.com/api/v1/projects/7c1e4a52-9b0d-4f3e-8a61-2d5f0c9e7b14/publish \
  -H "Authorization: Bearer $SETHERION_API_KEY"

Response

{ "ok": true, "url": "https://coffee-shop.setherion.app", "ready": true }

Publishing the same saved app twice is safe: the second call answers with the same address.

Edit, then publish

What is published is what is saved, and an edit is saved when it finishes. So an edit followed by a publish puts the change online:

const base = 'https://www.setherion.com/api/v1/projects'
const headers = {
  Authorization: `Bearer ${process.env.SETHERION_API_KEY}`,
  'Content-Type': 'application/json',
}

const edit = await fetch(`${base}/${appId}/edit`, {
  method: 'POST',
  headers,
  body: JSON.stringify({ prompt: 'Add a contact form' }),
}).then(r => r.json())

if (edit.ok) {
  const live = await fetch(`${base}/${appId}/publish`, { method: 'POST', headers }).then(r => r.json())
  console.log(live.url)
}

Errors