---
schema: agents-md/1.0
site_root: https://dev.1health.io/api/
route: /
site_path: /agents.md
kind: endpoints
api_version: n/a
source_version: staging-20260814 (app-observed routes; OpenAPI via 1H docs MCP; no pinned spec SHA)
generated_at: 2026-08-14T03:30:00Z
---

# 1health App Developer Agents.md Site (staging)

Machine-readable documentation of the 1health platform API for AI software-development agents, served at https://dev.1health.io/api/. Current coverage: every endpoint observed in five production applications, plus task-oriented category pages — not yet the full OpenAPI surface.

## How to use this site

- Start at [manifest.md](https://dev.1health.io/api/manifest.md) — one line per route; land directly on the right file.
- Or browse by task: [categories](https://dev.1health.io/api/categories/agents.md) group endpoints by what you're trying to do.
- Every route node has an `agents.md` (reference: what the endpoint does) and, where real-world usage exists, a sister `examples.md` (how production apps actually call it, verbatim code).
- Authentication: [quickstart](https://dev.1health.io/api/authentication/agents.md).

## URL grammar and file placement

- Path parameters: `{param}` braces in file content; `_param_` underscores in URLs (`/v3/patient/{patientId}/address` → `/v3/patient/_patientId_/address/`).
- Param-fold rule: an endpoint is documented in the `agents.md` of its nearest ancestor whose final segment is static — `GET /v3/patient/{id}` lives in `/v3/patient/agents.md`.
- One `agents.md` per site node; `kind: stub` nodes only group child routes.

## File schema

`agents.md` sections per endpoint: summary line, Overview, Authorization, Path/Query Parameters, Request Body, Responses, Example (curl). `examples.md` sections: Use Case Index, one `## METHOD route` section per endpoint with `### Example:` entries (Scenario, verbatim code, Resolved request, Response handling, Notes, and a Divergence note where real behaviour differs from the reference), then Flows. Examples are extracted from production applications and published without source attribution. Missing reference data uses the fixed placeholder string — files never invent content.

## Conventions

- **Base URLs**: production `https://1health.app.1health.io/api` · demo `https://demo.1health.io/api`
- **Pagination**: zero-based `page`, `size` default 50.
- **Error envelope**: not yet documented on this staging build — endpoint files list only endpoint-specific conditions.
- **GraphQL** (`/api/graphql`) and **WebSocket** (`/api/v1/notification`) exist but are out of scope for auto-generation; see the Other category page for observed GraphQL usage.

## Meta

Generated: 2026-08-14T03:30:00Z · Source: staging-20260814 (app-observed routes; OpenAPI via 1H docs MCP; no pinned spec SHA) · Feedback: nsethi@tachin.ai