> ## Documentation Index
> Fetch the complete documentation index at: https://docs.onvy.health/llms.txt
> Use this file to discover all available pages before exploring further.

# Introduction

> Use the OpenAPI-backed reference to explore the public Health API contract.

The API reference in this portal is backed by the public `health-api` OpenAPI contract.

## What you will find here

* The public API server URL
* Request and response schemas for public routes
* Path parameters, pagination parameters, and error contracts
* Bearer-token security definitions for protected resources

<Card title="OpenAPI source" icon="file-json" href="/api-reference/openapi.yaml">
  Download the spec that powers this reference.
</Card>

## Authentication

Most routes use bearer authentication:

```json theme={null}
"security": [
  {
    "bearerAuth": []
  }
]
```

Use `/authentication` for implementation guidance, then return here for endpoint-level details.

## Resource groups

The reference is grouped around the current public tags:

* `users`
* `baselines`
* `daily-records`
* `chat`
* `facts`
* `activities`
* `ai-summaries`
* `custom-records`
* `meals`

<Info>
  Webhook delivery is documented separately because outbound webhook events are not modeled as public API endpoints in the OpenAPI file.
</Info>