Platform API · Endpoints

Projects

A project is one app: its code, versions, database and addresses.

Base URLhttps://api.kalle.build/v1AuthBearer kalle_sk_…VersionKalle-Version: 2026-11-01

Create a project

namestringRequiredThe project name.

promptstringWhat to build. Kalle by Appmake starts planning straight away.

templatestringA starting point: shop, shopify, crm, bookings, saas, dashboard, portal and more.

plan_modebooleanWait for approval of the plan before building. Default true.

POST/v1/projects

curl https://api.kalle.build/v1/projects \
  -H "Authorization: Bearer $KALLE_API_KEY" \
  -H "Kalle-Version: 2026-11-01" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Lotus Yoga",
    "prompt": "A booking site for my yoga studio with 10-class passes and reminder emails",
    "template": "bookings",
    "plan_mode": true
  }'

Open in Appmake

List and get projects

GET /projects lists projects in the workspace. GET /projects/{id} returns one project with its status, live address, latest version and credits used.

Status	Meaning
`planning`	Kalle by Appmake is asking questions or writing the plan
`awaiting_approval`	A plan or action waits for approval
`building`	Work in progress
`live`	Published
`paused`	Out of credits and balance

GET/v1/projects/prj_8Hq2c

curl https://api.kalle.build/v1/projects/prj_8Hq2c \
  -H "Authorization: Bearer $KALLE_API_KEY" \
  -H "Kalle-Version: 2026-11-01"

Open in Appmake

Rename or delete

PATCH /projects/{id} changes the name. DELETE /projects/{id} deletes the project, its versions and its database. Deleting requires the platform:write scope and cannot be undone.

DELETE/v1/projects/prj_8Hq2c

curl https://api.kalle.build/v1/projects/prj_8Hq2c \
  -X DELETE \
  -H "Authorization: Bearer $KALLE_API_KEY" \
  -H "Kalle-Version: 2026-11-01"

Open in Appmake