Skip to content
Exepad Docs

Quickstart

Create a full-stack app from a prompt, iterate on it, and publish it to a live URL — with three API calls.

Prerequisites

Section titled “Prerequisites”
  1. An Exepad account on the Pro plan — the developer API is a Pro feature.
  2. An API key: create one in the Developer Console (Developers → New key). The full key (exepad_dk_…) is shown once — store it safely.
Terminal window
export EXEPAD_KEY="exepad_dk_..."

1. Create an app from a prompt

Section titled “1. Create an app from a prompt”
Terminal window
curl -X POST https://api.exepad.com/v1/apps \
  -H "Authorization: Bearer $EXEPAD_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Task Tracker",
    "description": "A task tracker with a backend: tasks have a title, a status (todo or done), and a due date. List, toggle, and delete tasks."
  }'

The response is 202 Accepted with the new app and a generation edit:

{
  "id": "uqon8zje",
  "name": "Task Tracker",
  "status": "draft",
  "preview_url": "https://p1.exepad.com/a/preview-uqon8zje/",
  "edit_id": "0e54fe3e-9acf-49bb-a4d5-77c56429eb40"
}

Generation is asynchronous — a full-stack app typically builds in 5–9 minutes. Poll the edit until it completes:

Terminal window
curl https://api.exepad.com/v1/apps/uqon8zje/edits/0e54fe3e-... \
  -H "Authorization: Bearer $EXEPAD_KEY"
# → { "status": "processing" } … → { "status": "completed" }

2. Edit it with a prompt

Section titled “2. Edit it with a prompt”
Terminal window
curl -X POST https://api.exepad.com/v1/apps/uqon8zje/edits \
  -H "Authorization: Bearer $EXEPAD_KEY" \
  -H "Content-Type: application/json" \
  -d '{"prompt": "Add a priority field (low/medium/high) shown as a colored badge, with a filter."}'

Same pattern: 202 with an edit id, poll to completed. See Create & edit apps for logs, streaming, and cancellation.

3. Publish

Section titled “3. Publish”
Terminal window
curl -X POST https://api.exepad.com/v1/apps/uqon8zje/deploy/publish \
  -H "Authorization: Bearer $EXEPAD_KEY" -d '{}'
{
  "status": "publishing",
  "mode": "production",
  "published_url": "https://task-tracker.exepad.app"
}

Poll GET /v1/apps/{id}/deploy/status until production.status is deployed (typically under two minutes), then open your app at its *.exepad.app URL.

What you were billed

Section titled “What you were billed”

Generation is billed from your USD wallet at published USD rates — a typical create is $1.50–2.50, an edit $0.50–1.50. Every operation appears as a line item in GET /v1/billing/ledger. Failed generations are not charged. See Pricing & billing.

Next steps

Section titled “Next steps”