# info.summary
Autonomous and clinician-facing hospital management API

# info.description
Comprehensive, HIPAA/GDPR-aligned hospital operating system API enabling AI agents and client applications to manage clinical scheduling, patient records, physiological vitals, emergency triage, radiology PACS, and pharmacy queues.

# servers[].description
HealOS Agent Testing Sandbox Environment

# tags[].description
Health probes, metadata, and service discovery

# tags[].description
Instant zero-friction test environment for agent evaluations

# tags[].description
Clinical booking, consultation scheduling, and calendar management

# tags[].description
Demographic profiles, longitudinal EHR records, and allergy indices

# tags[].description
Continuous and episodic physiological vital signs observation

# tags[].description
DICOM image orders, modality worklists, and radiologist reporting

# tags[].description
Specimen accession, analyzer validation, and critical callback feeds

# tags[].description
Emergency department triage board, ambulance inbound, and resus bay allocation

# paths./health.get.description
Returns operational health status, database connectivity, and uptime metrics.

# paths./health.get.responses.404.description
Resource Not Found (RFC 7807 Problem Details)

# paths./health.get.responses.500.description
Internal Server Error (RFC 7807 Problem Details)

# paths./catalog.get.description
Lists all public and authenticated clinical routes with capability metadata.

# paths./catalog.get.responses.404.description
Resource Not Found (RFC 7807 Problem Details)

# paths./catalog.get.responses.500.description
Internal Server Error (RFC 7807 Problem Details)

# paths./sandbox.get.description
Returns an instant zero-friction agent test token and synthetic hospital state. Requires no authentication headers or credit card.

# paths./sandbox.get.responses.404.description
Resource Not Found (RFC 7807 Problem Details)

# paths./sandbox.get.responses.500.description
Internal Server Error (RFC 7807 Problem Details)

# paths./sandbox.post.description
Issues a rate-limited evaluation token for autonomous AI agents testing clinical toolcalls.

# paths./sandbox.post.responses.404.description
Resource Not Found (RFC 7807 Problem Details)

# paths./sandbox.post.responses.500.description
Internal Server Error (RFC 7807 Problem Details)

# paths./appointments.get.description
Retrieves a paginated list of scheduled patient appointments filtered by date or provider.

# paths./appointments.get.parameters[].description
Filter appointments by ISO date (YYYY-MM-DD)

# paths./appointments.get.parameters[].description
Opaque cursor token for cursor-based pagination

# paths./appointments.get.responses.404.description
Resource Not Found (RFC 7807 Problem Details)

# paths./appointments.get.responses.500.description
Internal Server Error (RFC 7807 Problem Details)

# paths./appointments.post.description
Creates and confirms a new patient appointment with an assigned practitioner. Supports Idempotency-Key header.

# paths./appointments.post.parameters[].description
Unique UUID v4 key guaranteeing idempotent execution

# paths./appointments.post.responses.404.description
Resource Not Found (RFC 7807 Problem Details)

# paths./appointments.post.responses.500.description
Internal Server Error (RFC 7807 Problem Details)

# paths./jobs.post.description
Enqueues long-running clinical analytics, DICOM reconstruction, or lab report generation. Returns 202 Accepted with a polling Location header.

# paths./jobs.post.responses.404.description
Resource Not Found (RFC 7807 Problem Details)

# paths./jobs.post.responses.500.description
Internal Server Error (RFC 7807 Problem Details)

# paths./jobs/{id}.get.description
Polls completion progress and retrieves output results for an asynchronous workload.

# paths./jobs/{id}.get.responses.404.description
Resource Not Found (RFC 7807 Problem Details)

# paths./jobs/{id}.get.responses.500.description
Internal Server Error (RFC 7807 Problem Details)

# paths./batch.post.description
Executes multiple atomic clinical read or mutation operations within a single request context.

# paths./batch.post.responses.404.description
Resource Not Found (RFC 7807 Problem Details)

# paths./batch.post.responses.500.description
Internal Server Error (RFC 7807 Problem Details)

# paths./patients.get.description
Finds patient master demographic records matching name, MRN, or phone number.

# paths./patients.get.responses.404.description
Resource Not Found (RFC 7807 Problem Details)

# paths./patients.get.responses.500.description
Internal Server Error (RFC 7807 Problem Details)

# paths./patients/{id}/vitals.get.description
Returns recent telemetry and vitals observations for an admitted or outpatient individual.

# paths./patients/{id}/vitals.get.responses.404.description
Resource Not Found (RFC 7807 Problem Details)

# paths./patients/{id}/vitals.get.responses.500.description
Internal Server Error (RFC 7807 Problem Details)

# paths./patients/{id}/vitals.post.description
Records a vital signs observation during clinical nurse rounds.

# paths./patients/{id}/vitals.post.responses.404.description
Resource Not Found (RFC 7807 Problem Details)

# paths./patients/{id}/vitals.post.responses.500.description
Internal Server Error (RFC 7807 Problem Details)

# paths./emergency/triage.get.description
Fetches active Emergency Department triage board entries sorted by acuity (ESI 1-5).

# paths./emergency/triage.get.responses.404.description
Resource Not Found (RFC 7807 Problem Details)

# paths./emergency/triage.get.responses.500.description
Internal Server Error (RFC 7807 Problem Details)

# components.securitySchemes.OAuth2.description
OAuth 2.0 authorization with scoped access tokens

# components.securitySchemes.OAuth2.flows.authorizationCode.scopes.read:patients
Read patient medical records and demographic data

# components.securitySchemes.OAuth2.flows.authorizationCode.scopes.write:appointments
Book, reschedule, or cancel appointments

# components.securitySchemes.OAuth2.flows.authorizationCode.scopes.read:vitals
Access patient physiological vitals observations

# components.securitySchemes.OAuth2.flows.authorizationCode.scopes.read:reports
View diagnostic laboratory and radiology reports

# components.securitySchemes.BearerAuth.description
Personal Access Token or JWT session token

# components.schemas.SandboxTokenResponse.properties.message.example
Zero-friction agent testing sandbox active. No credit card or registration required.

# components.responses.BadRequestError.description
Invalid request payload or validation failure (RFC 7807 Problem Details)

# components.responses.UnauthorizedError.description
Authentication token missing, expired, or lacking required scope (RFC 7807 Problem Details)