Kalle Browser tasks
Give Kalle Browser a task on the web and follow it step by step. It asks before it pays or submits anything.
Base URLhttps://api.kalle.build/v1AuthBearer kalle_sk_…VersionKalle-Version: 2026-11-01
Start a task
taskstringRequiredWhat the browser should do, in plain words. At most 2,000 characters.start_urlstringThe page to start on.A task runs in the Kalle Browser extension of the person who created the API key, so it must be installed and connected to the workspace there. It uses the workspace's credits like a task started in Appmake. Which actions wait for approval follows the workspace's Kalle Browser permissions in Appmake.
POST/v1/browser/tasks
curl https://api.kalle.build/v1/browser/tasks \
-H "Authorization: Bearer $KALLE_API_KEY" \
-H "Kalle-Version: 2026-11-01" \
-H "Content-Type: application/json" \
-d '{
"task": "Find three venues in Aarhus for 40 people on 12 December and list their prices",
"start_url": "https://www.google.com"
}'Follow the task
Poll this endpoint to follow the task.
| Status | Meaning |
|---|---|
running | Working through the steps |
requires_action | Waiting for your approval, see pending_action: payment, form_submit or sign_in |
completed | Done. The result is in output |
failed | Stopped. The reason is in error |
cancelled | Stopped by you, or an action was turned down |
GET/v1/browser/tasks/btk_4d2e8f1a9b3c4d5e6f708192a3b4c5d6
curl https://api.kalle.build/v1/browser/tasks/btk_4d2e8f1a9b3c4d5e6f708192a3b4c5d6 \
-H "Authorization: Bearer $KALLE_API_KEY" \
-H "Kalle-Version: 2026-11-01"Approve or stop
Approve the pending action, or call /cancel to stop the task. Kalle Browser never types passwords: a sign-in waits as sign_in until a person signs in in that browser.
POST/v1/browser/tasks/btk_4d2e8f1a9b3c4d5e6f708192a3b4c5d6/approve
curl https://api.kalle.build/v1/browser/tasks/btk_4d2e8f1a9b3c4d5e6f708192a3b4c5d6/approve \
-X POST \
-H "Authorization: Bearer $KALLE_API_KEY" \
-H "Kalle-Version: 2026-11-01"