For Agents
Manage KumpeApps KKid family accounts: add child users, assign chores, record allowance transactions, manage wishlists, and send APNs push notifications.
Install Jentic One Beta
Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the KumpeApps API, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.
Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.
Step 1: Jentic One Host machine
# On the machine that will host your Jentic One instance:
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | shStep 2: Agent machine
# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh
jentic register # connects your agent to your Jentic One instanceJentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.
What an agent can do with KumpeApps API.
Issue and revoke app keys via /appkey to authorise applications calling the KKid API
Authenticate end users by requesting and deactivating auth keys through /authkey and verify YubiKey OTP via /authentication/verifyotp
Add child user accounts under a master user with POST /kkid/userlist and remove them with DELETE /kkid/userlist
GET STARTED
Use for: I need to add a new child account under a KumpeApps master user, I want to assign a chore to a child in KumpeApps, List all chores for a given child, Get the current allowance balance for my child
Not supported: Does not handle payroll, banking transfers, or general task management — use for KumpeApps KKid family chores, allowance, and wishlists only.
KumpeApps API exposes the KKid family-management platform: child user accounts, chore lists, allowance ledgers, wishlists, share links, and APNs push notification subscriptions. Authentication is two-tier — an X-Auth app key identifies the calling application and an X-Auth user auth key authorises actions on a specific account. Master users can add child accounts, assign chores, log allowance transactions, and manage wishlist items shared with family.
Track per-child chores by listing, adding, updating, and deleting entries on /kkid/chorelist
Record allowance transactions and read the running balance through /kkid/allowance
Manage children's wishlists and generate shareable wishlist links via /kkid/wishlist and /kkid/share
Patterns agents use KumpeApps API for, with concrete tasks.
★ Family Chore and Allowance Tracking
Run a household chore-and-allowance loop: parents assign chores via /kkid/chorelist, mark them complete, and post an allowance transaction to /kkid/allowance to credit the child. Balances and transaction history are read back from the same allowance endpoint, keeping the family ledger in one place.
On 'Sam finished the dishes', PATCH the matching /kkid/chorelist entry to complete and POST a $2 allowance transaction to /kkid/allowance for Sam's userID.
Child Wishlist Sharing
Maintain a child's wishlist as items are added across the year and produce a shareable link for grandparents and relatives. POST /kkid/wishlist adds items, PATCH updates them, and GET /kkid/share creates the share link that lets non-account holders view the wishlist for gifting occasions.
Add 'Lego Set 71043' to Sam's wishlist via POST /kkid/wishlist and call GET /kkid/share to produce a link to send to family.
Two-Factor Authenticated Family Account
Authenticate a parent with username and password via POST /authkey, then verify a YubiKey OTP through GET /authentication/verifyotp before performing sensitive actions like adding child accounts or processing larger allowance transactions. The dual app-key plus auth-key model isolates application identity from user identity.
POST /authkey with the parent's credentials, then GET /authentication/verifyotp with the YubiKey OTP before calling POST /kkid/userlist to add a new child.
AI Agent Family Assistant
An assistant in a parent's chat client tracks chores, applies allowance, and updates wishlists from natural language. Through Jentic, the assistant calls the right KKid operation by intent without hard-coded HTTP plumbing or storing the parent's auth key in the agent context.
On 'pay Sam $5 for finishing his chores this week', search Jentic for 'add KumpeApps allowance transaction' and POST to /kkid/allowance with kidUserID resolved from /kkid/userlist.
33 endpoints — kumpeapps api exposes the kkid family-management platform: child user accounts, chore lists, allowance ledgers, wishlists, share links, and apns push notification subscriptions.
METHOD
PATH
DESCRIPTION
/authkey
Log a user in and receive an auth key
/kkid/userlist
Add a child user under a master user
/kkid/chorelist
List chores for a given child
/kkid/chorelist
Add a chore for a child
/kkid/allowance
Get allowance balance and transaction history
/kkid/allowance
Add an allowance transaction for a child
/kkid/wishlist
Add an item to a child's wishlist
/authkey
Log a user in and receive an auth key
/kkid/userlist
Add a child user under a master user
/kkid/chorelist
List chores for a given child
/kkid/chorelist
Add a chore for a child
/kkid/allowance
Get allowance balance and transaction history
Three things that make agents converge on Jentic-routed access.
Credential isolation
KumpeApps app keys and user auth keys are stored encrypted in the Jentic MAXsystem vault. The X-Auth header is injected at execution time, so the agent never sees the raw keys.
Intent-based discovery
Agents search by intent (e.g. 'add an allowance transaction' or 'create a wishlist item') and Jentic returns the matching KKid operation with its input schema.
Time to first call
Direct integration: 4-8 hours for the dual-key auth flow and KKid resource model. Through Jentic: under 30 minutes — search, load, execute.
Alternatives and complements available in the Jentic catalogue.
Specific to using KumpeApps API through Jentic.
What authentication does the KumpeApps API use?
KumpeApps uses two API keys passed in the X-Auth header: an app_key that identifies the calling application and an auth_key that identifies the logged-in user. Through Jentic, both are stored encrypted in the MAXsystem vault.
Can I add a chore for a specific child with the KumpeApps API?
Yes. POST /kkid/chorelist creates a chore tied to a child's user ID, and PATCH /kkid/chorelist updates an existing chore by chore ID. GET /kkid/chorelist returns the chore list for the requested child.
How do I record an allowance payment through Jentic?
Search Jentic for 'add a KumpeApps allowance transaction'. Jentic returns POST /kkid/allowance with its schema. Provide the kidUserID and amount, and Jentic executes the call using your stored credentials.
Does KumpeApps support YubiKey two-factor authentication?
Yes. After logging in via POST /authkey, GET /authentication/verifyotp verifies a YubiKey OTP for the authenticated user. This lets sensitive operations require hardware-backed second factors.
What are the rate limits for the KumpeApps API?
Public rate limits are not documented in the spec. Contact KumpeApps support at helpdesk@kumpeapps.com to confirm limits for your access tier before scaling agent workloads.
How do I share a child's wishlist with family?
GET /kkid/share generates a share link for the wishlist; the link is suitable for sending to relatives so they can view items without holding a KumpeApps account. Items are added via POST /kkid/wishlist.
/kkid/allowance
Add an allowance transaction for a child
/kkid/wishlist
Add an item to a child's wishlist