reference
Technical reference material for Owlette's public API, platform internals, data model, agent command channel, and Cortex tool surface.
public API
- API reference - entrypoint for the rendered OpenAPI endpoint reference, request/response examples, and API-wide conventions.
- API authentication - API-key formats, bearer authentication, scope handling, and caller identity checks for external integrations.
platform internals
- Authentication internals - Firebase sessions, agent device-code pairing, passkeys, MFA, RBAC, and server auth helper boundaries.
- Firestore data model - collection hierarchy, document schemas, field meanings, indexes, and ownership patterns.
- Agent commands - command lifecycle, pending/completed document schemas, and command-specific payload fields accepted by the agent.
- Cortex tools - available tools, approval tiers, execution location, parameters, and response shapes.
whoami
whoami prints the server-resolved identity for the active profile — user id, email, the api key's scopes + environment, and the local config context the cli used to make the request. acts on the cli's own state (no site / machine targeting). tier: [ready].
platform authentication internals
This reference covers Owlette platform authentication internals: Firebase-backed user sessions, agent device-code pairing, passkey authentication (WebAuthn), optional MFA (TOTP), and role-based access control. For HTTP API integrations, use API authentication, which documents scoped owk_* API keys, bearer headers, scopes, and public API error behavior.