Build a task app
A task app is a small WebAssembly app. It runs in a company’s app runtime, inside its own secure space, next to its data plane. It reads what partners share and hands results to the company’s AI tool. Your app never sends the data to you or to Kaphera.
1. Create an API key
Keys are created per organisation (POST /v1/organisations/{id}/api-keys).
2. Quickstart
Exchange the key for a short-lived bearer token, then call the API.
bash
# 1. Exchange your API key for a short-lived bearer token (POST /v1/api-keys/exchange)
TOKEN=$(curl -s -X POST https://api.kaphera.cloud/v1/api-keys/exchange \
-H "Content-Type: application/json" \
-d '{"grant_type":"urn:ietf:params:oauth:grant-type:token-exchange","subject_token":"<YOUR_API_KEY>","subject_token_type":"<subject_token_type for API keys, see API reference>"}' \
| jq -r .access_token)
# 2. Call the API with the bearer token (GET .../edc/identities, list_identities)
curl -s https://api.kaphera.cloud/v1/organisations/<organisation_id>/edc/identities \
-H "Authorization: Bearer $TOKEN"The token type for API keys is not in the public spec yet; it is marked as a placeholder.
3. Publish to the app registry with the Kaphera CLI
PreviewCLI Preview
# Preview: the Kaphera CLI is not published yet. Command names are illustrative.
kaphera login
kaphera app build ./delivery-dates # → a small WebAssembly app (3–5 MB)
kaphera app publish ./delivery-dates --registry kapheraPricing Planned
Set a price for companies that add your app. Not available yet.
API referenceSDK and sandbox: request early access Planned