# Olira

## Docs

- [Authentication](https://docs.olira.ai/authentication.md): API keys for your backend services and short-lived patient tokens for devices: how each credential works and how to send them.
- [Authentication commands](https://docs.olira.ai/cli/authentication.md): Log in to Olira from the terminal: olira login, token, status, and logout.
- [MCP configuration](https://docs.olira.ai/cli/configure.md): Write MCP client config for your IDE with olira configure.
- [Credentials & exit codes](https://docs.olira.ai/cli/credentials.md): Where the CLI stores login credentials, token lifetimes, and exit codes.
- [Olira CLI](https://docs.olira.ai/cli/index.md): Lightweight CLI for authenticating with Olira, managing API keys, configuring MCP access, validating JSONL files, and managing historical data ingestion jobs.
- [Ingestion](https://docs.olira.ai/cli/ingest.md): Upload and manage historical data ingestion jobs with olira ingest.
- [API key commands](https://docs.olira.ai/cli/keys.md): Manage Olira API keys from the terminal: olira keys create, list, and revoke.
- [Scopes](https://docs.olira.ai/cli/scopes.md): API key scopes granted at creation and what each one allows.
- [Validation](https://docs.olira.ai/cli/validate.md): Validate JSONL files locally before uploading with olira validate.
- [Observability](https://docs.olira.ai/console/observability.md): Verify ingestion with the log browser, trace how events changed patient state, audit generated views, and inspect cohort-level population views.
- [Console overview](https://docs.olira.ai/console/overview.md): Tour of the Olira Console: navigation, the home dashboard, and the setup wizard that configures event types and view templates.
- [Patients](https://docs.olira.ai/console/patients.md): Find patients in the directory, enroll them in agent programs, and inspect a patient's compiled state, built views, and memory bank.
- [Playground](https://docs.olira.ai/console/playground.md): Run mock agents against real resolved patient state, call MCP tools manually, and generate synthetic datasets for experimentation.
- [Settings](https://docs.olira.ai/console/settings.md): Manage your team and roles, create API keys, connect MCP clients, and set organization security policies from the Console.
- [What is Olira?](https://docs.olira.ai/index.md): The patient context layer for clinical AI. Integrate once; your agents and workflows read complete, current patient state over API or MCP.
- [Authentication](https://docs.olira.ai/mcp-server/authentication.md): Token types, required scopes, and Patient Tokens for the Olira MCP Patient State server.
- [Error reference](https://docs.olira.ai/mcp-server/errors.md): HTTP status codes returned by the MCP Patient State server and what they mean.
- [MCP Patient State server](https://docs.olira.ai/mcp-server/index.md): The Olira MCP Patient State server: JSON-RPC tools, resources, and prompts over HTTP for querying patient state from agents and IDE clients.
- [Resources & prompts](https://docs.olira.ai/mcp-server/resources-and-prompts.md): URI-addressable resources and reusable prompt templates exposed by the MCP Patient State server (beta).
- [get_event_state_module](https://docs.olira.ai/mcp-server/tools/get-event-state-module.md): Get a specific event state module by type, such as symptoms or behavioral_state.
- [get_events](https://docs.olira.ai/mcp-server/tools/get-events.md): Get completed events for the patient with optional time, type, and trace filters.
- [get_logs](https://docs.olira.ai/mcp-server/tools/get-logs.md): Get event log entries for the patient with optional time, type, trace, and JMESPath projection filters.
- [get_stable_data](https://docs.olira.ai/mcp-server/tools/get-stable-data.md): Get stable patient data: demographics, condition/diagnosis, medications, preferences.
- [get_view](https://docs.olira.ai/mcp-server/tools/get-view.md): Get a specific patient view snapshot, raw JSON or rendered text.
- [get_view_block](https://docs.olira.ai/mcp-server/tools/get-view-block.md): Get a specific block from a view by block_id, with optional JMESPath filtering and diffs.
- [get_view_recent_events](https://docs.olira.ai/mcp-server/tools/get-view-recent-events.md): Get recent live-segment entries for a specific view type, before slower summarization steps.
- [Tools overview](https://docs.olira.ai/mcp-server/tools/index.md): Quick reference for the 10 MCP Patient State tools and the conventions they share.
- [list_event_state_modules](https://docs.olira.ai/mcp-server/tools/list-event-state-modules.md): List event state module types present for the patient.
- [list_views_and_blocks](https://docs.olira.ai/mcp-server/tools/list-views-and-blocks.md): List available views for the patient, optionally with blocks for a specific view type.
- [read_memories](https://docs.olira.ai/mcp-server/tools/read-memories.md): Read memories for a patient, optionally searching by query.
- [Quickstart](https://docs.olira.ai/quickstart.md): Create an API key, register a patient, send your first log, and read compiled patient state, end to end in a few minutes.
- [Accessing patient state](https://docs.olira.ai/read-data/accessing-patient-state.md): Read compiled patient data from your backend or agent runtime via the MCP Patient State server, the Python SDK, or REST.
- [Patient state](https://docs.olira.ai/read-data/patient-state.md): How Olira models a patient as structured modules over time: stable profile, event-driven modules, memory bank, and rendered views.
- [View configuration](https://docs.olira.ai/read-data/view-configuration.md): Curated view templates you can turn on quickly, deep per-block configuration in the builder, and an assistant that configures templates through conversation.
- [Views & templates](https://docs.olira.ai/read-data/views-and-templates.md): Templates define what should be built from patient state; views are the timestamped, patient-specific results agents and workflows consume.
- [Conversations](https://docs.olira.ai/reference/log-types/conversations.md): Conversation transcripts and interaction records from chat and voice channels. 3 log types with payload schemas and examples.
- [Engagement](https://docs.olira.ai/reference/log-types/engagement.md): Product and care engagement signals: check-ins, sessions, and interactions. 7 log types with payload schemas and examples.
- [Lab & clinical](https://docs.olira.ai/reference/log-types/lab-clinical.md): Lab results, clinical notes, imaging, procedures, encounters, and other clinical observations. 15 log types with payload schemas and examples.
- [Medication](https://docs.olira.ai/reference/log-types/medication.md): Medication actions, doses, and adverse events. 3 log types with payload schemas and examples.
- [Passive data](https://docs.olira.ai/reference/log-types/passive-data.md): Device-derived readings: heart rate, sleep, activity, glucose, and vitals. 6 log types with payload schemas and examples.
- [Profile](https://docs.olira.ai/reference/log-types/profile.md): Stable patient facts: demographics, conditions, care team, insurance, allergies, and related records. 13 log types with payload schemas and examples.
- [Questionnaires](https://docs.olira.ai/reference/log-types/questionnaires.md): Structured instrument submissions and scored questionnaires. 2 log types with payload schemas and examples.
- [Symptom reports](https://docs.olira.ai/reference/log-types/symptom-reports.md): Patient-reported symptoms, moods, and functional status assessments. 6 log types with payload schemas and examples.
- [Add patients to cohort](https://docs.olira.ai/reference/sdk/cohorts/add-patients-to-cohort.md): Adds one or more patients to a cohort.
- [Assign template to cohort](https://docs.olira.ai/reference/sdk/cohorts/assign-cohort-template.md): Assigns a summary type to a cohort.
- [Create cohort](https://docs.olira.ai/reference/sdk/cohorts/create-cohort.md): Creates a named patient cohort in your organization.
- [Delete cohort](https://docs.olira.ai/reference/sdk/cohorts/delete-cohort.md): Permanently deletes a cohort and cascades to all its template assignments.
- [Get cohort](https://docs.olira.ai/reference/sdk/cohorts/get-cohort.md): Returns a single cohort including the full list of enrolled patient ids.
- [List cohort templates](https://docs.olira.ai/reference/sdk/cohorts/list-cohort-templates.md): Returns all template assignments for a cohort.
- [List cohorts](https://docs.olira.ai/reference/sdk/cohorts/list-cohorts.md): Returns all cohorts for your organization sorted by name, with patient and template assignment counts.
- [Remove patients from cohort](https://docs.olira.ai/reference/sdk/cohorts/remove-patients-from-cohort.md): Removes one or more patients from a cohort.
- [Unassign template from cohort](https://docs.olira.ai/reference/sdk/cohorts/unassign-cohort-template.md): Removes a summary type assignment from a cohort.
- [Update cohort](https://docs.olira.ai/reference/sdk/cohorts/update-cohort.md): Updates a cohort's name or description.
- [Python SDK](https://docs.olira.ai/reference/sdk/index.md): Install and configure the Olira Python SDK: authentication, clients, error handling, models, and cohort management.
- [Cancel ingestion job](https://docs.olira.ai/reference/sdk/ingestion/cancel-ingestion-job.md): Cancels a job.
- [Confirm ingestion job](https://docs.olira.ai/reference/sdk/ingestion/confirm-ingestion-job.md): Confirms a job in awaiting_confirmation and starts Phase 2 (chronological graph replay + view backfill).
- [Create ingestion job](https://docs.olira.ai/reference/sdk/ingestion/create-ingestion-job.md): Starts a historical data ingestion job.
- [Delete ingestion job patient](https://docs.olira.ai/reference/sdk/ingestion/delete-ingestion-job-patient.md): Removes a patient and their STALE logs from a job while it is awaiting_confirmation.
- [Get ingestion job](https://docs.olira.ai/reference/sdk/ingestion/get-ingestion-job.md): Poll job status, stage, progress_pct, counters, and error_summary.
- [List ingestion jobs](https://docs.olira.ai/reference/sdk/ingestion/list-ingestion-jobs.md): Lists ingestion jobs for your organization, newest first.
- [Patch ingestion job](https://docs.olira.ai/reference/sdk/ingestion/patch-ingestion-job.md): Updates mutable fields while the job is awaiting_confirmation.
- [Retry view backfill](https://docs.olira.ai/reference/sdk/ingestion/retry-view-backfill.md): Retries view materialisation on a completed_with_errors job.
- [Query logs](https://docs.olira.ai/reference/sdk/log-query/logs.md): Returns a LogQuery builder scoped to one patient.
- [Query population logs](https://docs.olira.ai/reference/sdk/log-query/population-logs.md): Returns a LogQuery builder scoped to the whole organization or an explicit patient cohort.
- [Log](https://docs.olira.ai/reference/sdk/logs/log.md): Enqueues a single log for background delivery via the SDK worker (singleton after olira.init()).
- [Log batch](https://docs.olira.ai/reference/sdk/logs/log-batch.md): Sends one synchronous POST /v1/logs/batch with all events (bypasses the background worker).
- [Log FHIR resource](https://docs.olira.ai/reference/sdk/logs/log-fhir.md): Submits a single FHIR R4 resource JSON object.
- [Get event state module](https://docs.olira.ai/reference/sdk/patient-state/get-event-state-module.md): Fetches one event state module payload by type.
- [Get events](https://docs.olira.ai/reference/sdk/patient-state/get-events.md): Lists derived state events (processed pipeline events), optionally filtered by log_type / trace / status.
- [Get logs](https://docs.olira.ai/reference/sdk/patient-state/get-logs.md): Reads ingested logs for the patient.
- [Get stable data](https://docs.olira.ai/reference/sdk/patient-state/get-stable-data.md): Reads stable (slow-changing) modules: demographics, condition_diagnosis, medications, user_preferences.
- [Get view](https://docs.olira.ai/reference/sdk/patient-state/get-view.md): Returns a view snapshot: content.blocks (unified v2 model) plus content.temp when live TEMP rows exist.
- [Get view block](https://docs.olira.ai/reference/sdk/patient-state/get-view-block.md): Fetches a single compiled block from a view.
- [Get view recent events](https://docs.olira.ai/reference/sdk/patient-state/get-view-recent-events.md): Returns recent TEMP segment string lines for a view (rolling append-only activity).
- [List event state modules](https://docs.olira.ai/reference/sdk/patient-state/list-event-state-modules.md): Lists event-driven state module types present for the patient (metadata only).
- [List view blocks](https://docs.olira.ai/reference/sdk/patient-state/list-view-blocks.md): Lists blocks within a view from the unified block list (metadata: block_id, block_name, has_result).
- [List views](https://docs.olira.ai/reference/sdk/patient-state/list-views.md): Lists view metadata for the patient (view_type, view_id, has_blocks, has_temp).
- [Read memories](https://docs.olira.ai/reference/sdk/patient-state/read-memories.md): Reads memory_bank entries.
- [Get patient token](https://docs.olira.ai/reference/sdk/patient-token/get-patient-token.md): Mints a short-lived JWT scoped to one patient (default ~15 minutes).
- [Create patient](https://docs.olira.ai/reference/sdk/patients/create-patient.md): Creates a patient in your organization.
- [Batch create patients](https://docs.olira.ai/reference/sdk/patients/create-patients-batch.md): Creates up to 500 patients in one request.
- [Delete patient](https://docs.olira.ai/reference/sdk/patients/delete-patient.md): Soft-deletes a patient (API semantics per platform).
- [Get patient](https://docs.olira.ai/reference/sdk/patients/get-patient.md): Fetch one patient by Olira-assigned id.
- [List patients](https://docs.olira.ai/reference/sdk/patients/list-patients.md): Paginated list of patients in your organization.
- [Update patient](https://docs.olira.ai/reference/sdk/patients/update-patient.md): Patch-style update: only supplied fields change.
- [Absorbers](https://docs.olira.ai/send-data/absorbers.md): Absorbers map external data formats like FHIR R4 into Olira event types automatically, so you send standard payloads instead of building Olira-shaped logs.
- [Backfilling historical data](https://docs.olira.ai/send-data/historical-backfill.md): Load large volumes of past data in one controlled job with historical ingestion: JSONL upload, review, confirmation, replay, and view backfill.
- [How logs work](https://docs.olira.ai/send-data/how-logs-work.md): What happens when you submit a log, the fields on every submission, and the difference between lifecycle-tracked logs and point-in-time records.
- [Integrations](https://docs.olira.ai/send-data/integrations.md): Connect EMR/EHR systems, health-information exchanges, devices, and wearables so external data feeds Olira alongside your own logs.
- [Logging from your codebase](https://docs.olira.ai/send-data/logging-from-codebase.md): Wire your backend to the Olira Python SDK: initialize the client, register patients, and emit logs that drive patient state.
- [Setup & data configuration](https://docs.olira.ai/setup.md): Provision your organization, invite your team, create API keys, and select the data that flows through Olira.