What is an App?
An App is a self-contained AI assistant environment that encapsulates:
Each App is fully isolated. Its tools and configuration have no visibility into other Apps.
App Keys
App keys are issued by Aomi and scoped to one or more Apps.Properties
- Scoped: each key authorizes access to specific Apps
- Stored securely: keys are hashed in the database
- Revocable: keys can be deactivated without affecting the App
Usage
Include the App key in theAOMI-APP-KEY header. The chat message rides in the query string as message:
Scoping
A single key can authorize multiple Apps:Authentication Flow
Sessions
Sessions represent conversation threads identified by a UUID in theX-Session-Id header.
Properties
- ID: client-generated UUID
- Messages: full conversation history
- Wallet binding: optional association with a wallet address
- Processing status: idle, processing, or interrupted
Lifecycle
Sessions use a three-tier load strategy:- Memory cache: check if the session is active in memory
- Database: load persisted session from PostgreSQL
- Create new: if not found, create a fresh session
Wallet Binding
Sessions can be associated with a wallet address for cross-session context and wallet-aware tool calls.Default App
Aomi provides adefault App accessible without an App key. Useful for public demos, evaluation, and testing. The default App has general-purpose tools but no custom configuration. For production, use a scoped App key with your own App.
Headers Reference
Next Steps
- API Reference: full endpoint documentation
- Sessions: session management deep dive
- Quickstart: get a working integration in 5 minutes