kareenosdocs

Apps and K-APIs

Open in Kareenos

Register an application, give it routes backed by your jobs, manage its users and its published versions.

On this page

An App is an application your own team builds outside the Kareenos screens: a web application, later a mobile one. Its K-APIs are the routes that application calls to sign users up, sign them in and read or write your data. Each route runs an automated job you own. If the application is a web application, Kareenos can also host it at its own address.

Where to find it

Press Open in Kareenos above, or open Settings and choose the Apps & K-APIs tab. It needs an account administrator.

When to use it

Use it when your customers, drivers, members or partners should use an application of yours rather than the Kareenos screens, and that application should read and write the same data your team works with. Typical routes are sign up, sign in, "my profile", "my orders", "place an order".

Step by step: registering an application

  1. Press New App. Give it a name (this becomes the address https://<name>.kareenos.com: lowercase letters, digits and hyphens, free across the platform), a description, and the project whose jobs will serve it.
  2. Press Create and show secret. The dialog shows the app key (public, part of every route address) and the app secret (shown once). Store the secret in your records; it never goes into the application itself.
  3. Press the application's routes button and add a route: a name (it becomes the last part of the address), public or authenticated, and the handler job that runs it. Public routes are for sign up and sign in; everything else should require the session the sign-in route returns.
  4. Press Try it on a route to call it exactly as the application would, and open Calls to see the recent calls with their results.
  5. Hand the developer the base address, the app key and the routes table. The curl and JavaScript snippets on each route are ready to paste.

Versions of a hosted web application

If the application is a web application published on Kareenos, press Versions to see what has been pushed and what is live. Activate an older version to roll back, redeploy the current one, upload a bundle by hand, or probe the address. Build web apps with Claude Code walks through the whole flow.

Users of the application

People who sign up through the application become the application's own users, listed in the End users column. They are separate from your team's Kareenos users and never see the Kareenos screens. Rotating the application's secret signs every one of them out; disabling the application makes every route answer "not found" while keeping everything in place.

Common mistakes

  • Pasting the secret into the application. Only the app key belongs in the application. The secret stays in your records.
  • Making a business route public. Public means anyone who knows the address can call it. Keep it for sign up and sign in.
  • A route whose job is not approved yet. Routes answer "temporarily unavailable" until their job is approved and enabled.
  • Deleting instead of disabling. Deleting an application removes its users and its versions. Disable it when the application might come back.

Next