# Cuvo Integrations API

> The public telehealth consult platform. A partner creates patients, records consents, files cases for a licensed clinician to decide, and follows prescriptions and orders through events and webhooks. Test mode runs the whole loop against a sandbox.

## Guides

- [Getting started](https://developers.cuvo.co/docs/getting-started): Mint a test key, make your first call, and drive a whole consult against the sandbox.
- [Authentication](https://developers.cuvo.co/docs/authentication): API keys and OAuth clients, how each is minted and rotated, and what live mode asks for first.
- [Scopes and organizations](https://developers.cuvo.co/docs/scopes-and-organizations): What a credential may do, who it may do it for, and how a clinic grants you access.
- [Test mode](https://developers.cuvo.co/docs/test-mode): The sandbox, the simulated clinician and pharmacy, and how to drive a whole consult without one.
- [Cases](https://developers.cuvo.co/docs/cases): Filing an asynchronous consult, the statuses it moves through, and what falls out of a decision.
- [Patients and consents](https://developers.cuvo.co/docs/patients-and-consents): Creating the identity a case is filed under, recording what the patient accepted, and honouring a deletion request.
- [Files](https://developers.cuvo.co/docs/files): Reserving an upload, PUTting the bytes, confirming, and the one id that changes on the way.
- [Labs](https://developers.cuvo.co/docs/labs): Lab orders placed through Cuvo's lab network, the reports that come back, corrections, and the short-lived PDF link.
- [Visits](https://developers.cuvo.co/docs/visits): Booking a video consult with a licensed clinician, moving or cancelling it, and the short-lived link the patient joins through.
- [Webhooks](https://developers.cuvo.co/docs/webhooks): Registering an endpoint, verifying a signature, and what happens when your receiver is down.
- [Events and realtime](https://developers.cuvo.co/docs/events-and-realtime): The event catalog, polling as the backstop, and a subscribe-only channel for the moments you want live.
- [Billing](https://developers.cuvo.co/docs/billing): What gets charged, how to read the usage ledger, and how an invoice reconciles to it.
- [Errors](https://developers.cuvo.co/docs/errors): The problem body every failure answers with, the machine codes to switch on, and what each one means you should do.
- [Rate limits and idempotency](https://developers.cuvo.co/docs/rate-limits-and-idempotency): The per-credential limit, and the header every write requires so a retry never creates a second row.
- [Pagination](https://developers.cuvo.co/docs/pagination): One cursor envelope for every list, why there is no total, and how to page a backfill.
- [Versioning](https://developers.cuvo.co/docs/versioning): What we may change without telling you, what we may not, and how long a deprecation runs.
- [MCP server](https://developers.cuvo.co/docs/mcp): The Model Context Protocol door at mcp.cuvo.co, the tools behind it, and how an agent authenticates.
- [SDKs](https://developers.cuvo.co/docs/sdks): The TypeScript and Python clients, what each adds over raw fetch, and how their types stay honest.
- [CLI](https://developers.cuvo.co/docs/cli): The cuvo command, how it signs you in, and how an operation becomes a command.

## Reference

- [OpenAPI 3.1 contract](https://developers.cuvo.co/docs/openapi.yaml): every operation, generated from the schemas the server validates with.
- [Postman collection](https://developers.cuvo.co/docs/postman.json): the same contract, as a collection.
- [Changelog](https://developers.cuvo.co/docs/changelog): every change to the v1 contract, newest first.
- [Agent skill](https://developers.cuvo.co/skills/cuvo-api/SKILL.md): the same guidance packaged for an agent.
- [All guides in one file](https://developers.cuvo.co/llms-full.txt): every guide below, concatenated.