Platform API · Endpoints

Project messages

Ask Kalle by Appmake to change a project, the same way you would in the builder chat.

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

Send a message

contentstringRequiredWhat to change, in plain words.

modelstringauto (default) or a Kalle by Appmake model ID.

effortstringauto (default) or an effort level.

auto_approvebooleanSkip the approval step for changes under 20 credits. Default false.

Work uses credits from the workspace. Actions that always need a person, such as deleting data or sending email to real customers, still wait for approval in Appmake.

POST/v1/projects/prj_8Hq2c/messages

curl https://api.kalle.build/v1/projects/prj_8Hq2c/messages \
  -H "Authorization: Bearer $KALLE_API_KEY" \
  -H "Kalle-Version: 2026-11-01" \
  -H "Content-Type: application/json" \
  -d '{
    "content": "Add a waitlist when a class is full",
    "model": "auto",
    "effort": "auto"
  }'

Open in Appmake

Approve the plan

When the work is done, the message status becomes completed with a summary and the new version. Subscribe to project.message.completed to know when.

POST/v1/projects/prj_8Hq2c/messages/pmsg_3Lw9/approve

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

Open in Appmake