# ONVY Health API

## Docs

- [AI capabilities](https://docs.onvy.health/ai-capabilities.md): Use ONVY chat completions and AI summaries on top of harmonized health context.
- [Create activity](https://docs.onvy.health/api-reference/activities/create-activity.md): Create a new activity (workout or mindfulness session)
- [Delete activity](https://docs.onvy.health/api-reference/activities/delete-activity.md): Delete a specific activity
- [Get activity](https://docs.onvy.health/api-reference/activities/get-activity.md): Get a specific activity by ID
- [List activities](https://docs.onvy.health/api-reference/activities/list-activities.md): Get paginated list of user activities (workouts and mindfulness sessions)
- [Update activity (PATCH)](https://docs.onvy.health/api-reference/activities/update-activity-patch.md): Partially update an activity
- [Update activity (PUT)](https://docs.onvy.health/api-reference/activities/update-activity-put.md): Fully update an activity
- [Create AI summary](https://docs.onvy.health/api-reference/ai-summaries/create-ai-summary.md): Create a new AI-generated summary. The public create surface currently accepts `type=meal`; the resulting `MealSummary` is retrievable through the list and detail routes alongside system-generated summary types.
- [Delete AI summary](https://docs.onvy.health/api-reference/ai-summaries/delete-ai-summary.md): Delete a specific AI summary
- [Get AI summary](https://docs.onvy.health/api-reference/ai-summaries/get-ai-summary.md): Get a specific AI-generated summary by ID
- [List AI summaries](https://docs.onvy.health/api-reference/ai-summaries/list-ai-summaries.md): List AI-generated summaries for a user. Filter by `name` to scope to a specific summary type (`MealSummary`, `WorkoutSummary`, `MindfulsessionSummary`, `SleepSummary`, `DailySummary`, `DailyNutritionSummary`, `WeeklySummary`, `WeeklyActivitySummary`, `WeeklyNutritionSummary`, `TrendSummary`, `Impact…
- [Update AI summary (PATCH)](https://docs.onvy.health/api-reference/ai-summaries/update-ai-summary-patch.md): Partially update an AI summary
- [Update AI summary (PUT)](https://docs.onvy.health/api-reference/ai-summaries/update-ai-summary-put.md): Fully update an AI summary
- [Delete baseline](https://docs.onvy.health/api-reference/baselines/delete-baseline.md): Delete a specific baseline
- [Get specific baseline](https://docs.onvy.health/api-reference/baselines/get-specific-baseline.md): Get a specific baseline for a user
- [List user baselines](https://docs.onvy.health/api-reference/baselines/list-user-baselines.md): Get all baselines for a specific user
- [Update baseline (PUT)](https://docs.onvy.health/api-reference/baselines/update-baseline-put.md): Fully update a baseline
- [Create chat completion](https://docs.onvy.health/api-reference/chat/create-chat-completion.md): OpenAI-compatible chat completion endpoint with user context
- [Delete chat completion](https://docs.onvy.health/api-reference/chat/delete-chat-completion.md): Delete a specific chat completion message
- [Get chat completion](https://docs.onvy.health/api-reference/chat/get-chat-completion.md): Get a specific chat completion message
- [List chat completions](https://docs.onvy.health/api-reference/chat/list-chat-completions.md): Get paginated list of chat messages
- [Update chat completion (PATCH)](https://docs.onvy.health/api-reference/chat/update-chat-completion-patch.md): Partially update a chat completion
- [Update chat completion (PUT)](https://docs.onvy.health/api-reference/chat/update-chat-completion-put.md): Fully update a chat completion
- [Create custom record](https://docs.onvy.health/api-reference/custom-records/create-custom-record.md): Create a new custom record for a user
- [Create custom record type](https://docs.onvy.health/api-reference/custom-records/create-custom-record-type.md): Create a new custom record type for the project
- [Get custom record](https://docs.onvy.health/api-reference/custom-records/get-custom-record.md): Get a specific custom record by ID
- [Get custom record type](https://docs.onvy.health/api-reference/custom-records/get-custom-record-type.md): Get a custom record type by ID
- [List custom record types](https://docs.onvy.health/api-reference/custom-records/list-custom-record-types.md): List custom record types for the project
- [List custom records](https://docs.onvy.health/api-reference/custom-records/list-custom-records.md): List custom records for a user with optional filtering by type
- [Update custom record type](https://docs.onvy.health/api-reference/custom-records/update-custom-record-type.md): Update an existing custom record type
- [Create daily record](https://docs.onvy.health/api-reference/daily-records/create-daily-record.md): Create a new daily record (scores, zones, or logs)
- [Delete daily record](https://docs.onvy.health/api-reference/daily-records/delete-daily-record.md): Delete a specific daily record
- [Get daily records by day](https://docs.onvy.health/api-reference/daily-records/get-daily-records-by-day.md): Get all daily records of a specific type for a given day
- [Get specific daily record](https://docs.onvy.health/api-reference/daily-records/get-specific-daily-record.md): Get a specific daily record by name and date
- [List daily records](https://docs.onvy.health/api-reference/daily-records/list-daily-records.md): List all daily records of specified type with optional filtering
- [Update daily record (PATCH)](https://docs.onvy.health/api-reference/daily-records/update-daily-record-patch.md): Partially update a daily record
- [Update daily record (PUT)](https://docs.onvy.health/api-reference/daily-records/update-daily-record-put.md): Fully update a daily record
- [Create fact](https://docs.onvy.health/api-reference/facts/create-fact.md): Add a new fact for user individualization
- [Delete fact](https://docs.onvy.health/api-reference/facts/delete-fact.md): Delete a specific fact
- [Get fact](https://docs.onvy.health/api-reference/facts/get-fact.md): Get a specific fact by ID
- [List facts](https://docs.onvy.health/api-reference/facts/list-facts.md): Get paginated list of user facts
- [Update fact (PATCH)](https://docs.onvy.health/api-reference/facts/update-fact-patch.md): Partially update a fact
- [Update fact (PUT)](https://docs.onvy.health/api-reference/facts/update-fact-put.md): Fully update a fact
- [Introduction](https://docs.onvy.health/api-reference/introduction.md): Use the OpenAPI-backed reference to explore the public Health API contract.
- [Create meal](https://docs.onvy.health/api-reference/meals/create-meal.md): Create a new meal for a user. This endpoint stores the meal and triggers asynchronous nutrition analysis. The response includes the meal with analysis_status='pending'. When analysis completes, a 'meals:updated' webhook will be sent with full nutrition data, and the meal's `summary_id` will referenc…
- [Delete meal](https://docs.onvy.health/api-reference/meals/delete-meal.md): Delete a specific meal and its related AI summary
- [Get meal](https://docs.onvy.health/api-reference/meals/get-meal.md): Get a specific meal by ID
- [List meals](https://docs.onvy.health/api-reference/meals/list-meals.md): Get paginated list of meals for a user
- [Update meal (PATCH)](https://docs.onvy.health/api-reference/meals/update-meal-patch.md): Partially update a meal. Updating meal content (description, image, comment, portion_multiplier, meal_time) will trigger asynchronous re-analysis.
- [Update meal (PUT)](https://docs.onvy.health/api-reference/meals/update-meal-put.md): Fully update a meal. Updating meal content (description, image, comment, portion_multiplier, meal_time) will trigger asynchronous re-analysis.
- [Fetch habits headers](https://docs.onvy.health/api-reference/static/fetch-habits-headers.md): Retrieve the headers for habits data
- [Get list of habits](https://docs.onvy.health/api-reference/static/get-list-of-habits.md): Get a list of habits (Notion sourced)
- [Create a new user](https://docs.onvy.health/api-reference/users/create-a-new-user.md): Create a new user in the system
- [Delete user](https://docs.onvy.health/api-reference/users/delete-user.md): Permanently delete a user and all associated data
- [Get user by ID](https://docs.onvy.health/api-reference/users/get-user-by-id.md): Retrieve detailed information about a specific user
- [List users](https://docs.onvy.health/api-reference/users/list-users.md): List all users in the project with pagination
- [Update user (PATCH)](https://docs.onvy.health/api-reference/users/update-user-patch.md): Partially update user information
- [Update user (PUT)](https://docs.onvy.health/api-reference/users/update-user-put.md): Fully update user information
- [Authentication](https://docs.onvy.health/authentication.md): Authenticate with ONVY bearer tokens and choose the right OAuth flow for your integration.
- [ONVY Health API](https://docs.onvy.health/index.md): Integrate ONVY health data, AI capabilities, and webhook events into your product.
- [Ingestion and processing](https://docs.onvy.health/ingestion-and-processing.md): See how provider payloads become harmonized records, scores, and AI outputs.
- [Quickstart](https://docs.onvy.health/quickstart.md): Authenticate with the Health API, create a user, and make your first request.
- [Resources and pagination](https://docs.onvy.health/resources-and-pagination.md): Understand the main Health API resource families and how opaque pagination works.
- [Webhooks](https://docs.onvy.health/webhooks.md): Configure ONVY webhook delivery and verify HMAC-signed event payloads.

## OpenAPI Specs

- [openapi](https://docs.onvy.health/api-reference/openapi.yaml)

## Optional

- [ONVY](https://onvy.health)
- [Support](mailto:support@onvy.health)