Platform API · Get started

Platform API

Read your workspace's projects and usage from your own code. More of Appmake comes to the API step by step.

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

Basics

The Platform API uses the same base URL, keys and version header as the Kalle by Appmake API. Any key of the workspace can use it.

Object	ID prefix
Project	`prj_`
Kalle Browser task	`btk_`
File	`file_`

GET/v1/projects

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

Open in Appmake

What is available

Endpoint	Status
`GET /projects`, `GET /projects/{id}`	Available
`PATCH /projects/{id}` (rename)	Available
`GET /usage`	Available
`POST /projects`, `DELETE /projects/{id}`	Not yet: `501`
Project messages, deployments, domains, database, webhooks	Not yet: `501`

Endpoints that are not available yet answer 501 with not_implemented_error, so your code can tell them apart from a typo, which is a 404. Do the same work in Appmake for now.

Pagination

List endpoints return up to limit items (default 20, max 100) and has_more. To get the next page, pass the last ID as starting_after.

Idempotency

Send an Idempotency-Key header with any POST. If the same key is sent again within 24 hours, you get the first response back instead of running the request twice. See Errors.