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

# Welcome to the Medera API

> AI infrastructure for behavioral and mental health

The Medera API brings behavioral-health-native AI — multimodal sensing, text generation, agentic workflows, and medical coding — into any application. The fastest path to integration is through our official SDKs, which handle authentication, token refresh, WebSocket connections, pagination, retries, and error handling so you can focus on building your behavioral-health application.

<Tip>
  Whether you're installing an SDK by hand or prompting an AI coding assistant, you can go from zero to a working API call in a few minutes.
</Tip>

<Columns cols={3}>
  <Card title="Introduction" icon="https://mintcdn.com/medera-357fd587/iC-6rAuwl-0aQSw_/icons/ui/layers.svg?fit=max&auto=format&n=iC-6rAuwl-0aQSw_&q=85&s=b19e6f39887a8a61762fcb53957d2271" href="/about/introduction" width="40" height="40" data-path="icons/ui/layers.svg">
    Overview of the Medera API and the behavioral-health-native tech stack
  </Card>

  <Card title="SDK Quickstart" icon="https://mintcdn.com/medera-357fd587/iC-6rAuwl-0aQSw_/icons/ui/rocket.svg?fit=max&auto=format&n=iC-6rAuwl-0aQSw_&q=85&s=3589c7c988f4bcd5e2811bac87becdb9" href="/sdks/overview" width="40" height="40" data-path="icons/ui/rocket.svg">
    Get oriented with Medera SDKs, patterns, and examples
  </Card>

  <Card title="Build with AI Coding Tools" icon="https://mintcdn.com/medera-357fd587/n1mgcc3nR2sq_PoL/icons/ui/sparkles.svg?fit=max&auto=format&n=n1mgcc3nR2sq_PoL&q=85&s=b836170ab3900fdb1a58f09bf057ec37" href="/quickstart/ai-coding-tools" width="40" height="40" data-path="icons/ui/sparkles.svg">
    Use Claude Code, Cursor, or Codex with our SDKs to ship integrations faster
  </Card>
</Columns>

## Core capabilities

<Card title="Multimodal Sensing" icon="https://mintcdn.com/medera-357fd587/iC-6rAuwl-0aQSw_/icons/ui/audio-lines.svg?fit=max&auto=format&n=iC-6rAuwl-0aQSw_&q=85&s=a4f3136aa8df6fe2d044778c71ba2bbc" href="/multimodal/overview" horizontal width="40" height="40" data-path="icons/ui/audio-lines.svg">
  with vocal acoustics, facial physiology, and the Neurobehavioral Construct Computer
</Card>

<Card title="Text Generation" icon="https://mintcdn.com/medera-357fd587/n1mgcc3nR2sq_PoL/icons/ui/text-align-start.svg?fit=max&auto=format&n=n1mgcc3nR2sq_PoL&q=85&s=730c3b374df501e7694db27465e52760" href="/textgen/overview" horizontal width="40" height="40" data-path="icons/ui/text-align-start.svg">
  for reliable behavioral-health LLM output — SOAP notes, intake summaries, PA letters
</Card>

<Card title="Agentic Framework" icon="https://mintcdn.com/medera-357fd587/iC-6rAuwl-0aQSw_/icons/ui/layers.svg?fit=max&auto=format&n=iC-6rAuwl-0aQSw_&q=85&s=b19e6f39887a8a61762fcb53957d2271" href="/agentic/overview" horizontal width="40" height="40" data-path="icons/ui/layers.svg">
  to build canvas-based agents and 17-state workflow automation
</Card>

<Card title="Medical Coding" icon="https://mintcdn.com/medera-357fd587/iC-6rAuwl-0aQSw_/icons/ui/asterisk.svg?fit=max&auto=format&n=iC-6rAuwl-0aQSw_&q=85&s=71fe571e24cdf6674f34378949a61920" href="/coding/overview" horizontal width="40" height="40" data-path="icons/ui/asterisk.svg">
  for ICD-10, CPT, HCPCS, SNOMED CT, LOINC, RxNorm with clinical-grade precision
</Card>

## Official SDKs

The fastest way to integrate the Medera API is through our official SDKs. They handle authentication, token refresh, WebSocket connections, pagination, retries, and error handling — so you can focus on building your behavioral-health application instead of API plumbing.

<CardGroup cols={2}>
  <Card title="JavaScript / TypeScript SDK" icon="https://mintcdn.com/medera-357fd587/iC-6rAuwl-0aQSw_/icons/ui/js.svg?fit=max&auto=format&n=iC-6rAuwl-0aQSw_&q=85&s=aef8433d52b791d35cf56eb56a4dc456" href="/sdks/js/overview" width="40" height="40" data-path="icons/ui/js.svg">
    Full-featured SDK for Node.js, browsers, and edge runtimes. Supports every REST endpoint, real-time WebSocket streaming, and every authentication flow.

    ```bash theme={null} theme={"system"}
    npm install @medera/sdk
    ```
  </Card>

  <Card title="Python SDK" icon="https://mintcdn.com/medera-357fd587/iC-6rAuwl-0aQSw_/icons/ui/python.svg?fit=max&auto=format&n=iC-6rAuwl-0aQSw_&q=85&s=b290890ff4e5e0335c3c49126e9e02af" href="/sdks/python/overview" width="40" height="40" data-path="icons/ui/python.svg">
    Async-first SDK for Python 3.10+, fully typed via Pydantic. Full API coverage with WebSocket support.

    ```bash theme={null} theme={"system"}
    pip install medera
    ```
  </Card>
</CardGroup>

### Why use an SDK?

|                      | Raw API calls                                            | With an SDK                                 |
| :------------------- | :------------------------------------------------------- | :------------------------------------------ |
| **Authentication**   | Manual token exchange and refresh logic                  | Automatic — just provide credentials        |
| **Token management** | Track expiry, handle refresh races, store tokens         | Built-in with thread-safe refresh           |
| **WebSockets**       | Raw connection management, reconnection, message parsing | Managed connections with typed events       |
| **Type safety**      | Manual request/response validation                       | Full TypeScript / Pydantic type definitions |
| **Error handling**   | Parse HTTP status codes and error bodies                 | Typed exceptions with structured details    |
| **Pagination**       | Manual cursor tracking                                   | `for await` / `async for` iteration         |
| **Retries**          | Implement backoff for 429 / 5xx                          | Configurable automatic retries              |

## Start building

<Columns cols={2}>
  <Card title="Review the API Reference" icon="https://mintcdn.com/medera-357fd587/n1mgcc3nR2sq_PoL/icons/ui/square-terminal.svg?fit=max&auto=format&n=n1mgcc3nR2sq_PoL&q=85&s=f4998a194e982ebc021d94929e523c12" href="/api-reference/welcome" width="40" height="40" data-path="icons/ui/square-terminal.svg">
    for all WebSocket, REST, Agentic, and Admin API specifications
  </Card>

  <Card title="Embed the Medera Dictation Component" icon="https://mintcdn.com/medera-357fd587/iC-6rAuwl-0aQSw_/icons/ui/mic.svg?fit=max&auto=format&n=iC-6rAuwl-0aQSw_&q=85&s=2fa5bf2e6c0f7c96c6db63c83d109eb1" href="/sdks/dictation-component" width="40" height="40" data-path="icons/ui/mic.svg">
    to get started with AI scribing workflows in your application today
  </Card>
</Columns>

<Card title="Get Access" icon="https://mintcdn.com/medera-357fd587/iC-6rAuwl-0aQSw_/icons/ui/key.svg?fit=max&auto=format&n=iC-6rAuwl-0aQSw_&q=85&s=4ef54e51baa6c73498065cb90a8834ff" href="https://medera.info/contact" horizontal width="40" height="40" data-path="icons/ui/key.svg">
  to API credentials, sandbox environment, and account management
</Card>

***

### Resources

<Columns cols={2}>
  <Card title="Release notes" icon="https://mintcdn.com/medera-357fd587/iC-6rAuwl-0aQSw_/icons/ui/bookmark.svg?fit=max&auto=format&n=iC-6rAuwl-0aQSw_&q=85&s=3423b0dda14a2c98642fdb7bdbf8344e" href="/release-notes/overview" width="40" height="40" data-path="icons/ui/bookmark.svg">
    Learn about upcoming changes and recent API, model, and platform updates
  </Card>

  <Card title="Support center" icon="https://mintcdn.com/medera-357fd587/iC-6rAuwl-0aQSw_/icons/ui/life-buoy.svg?fit=max&auto=format&n=iC-6rAuwl-0aQSw_&q=85&s=7e8a8981cb326bb6be88f1cff8db2747" href="https://medera.info/contact" arrow="true" width="40" height="40" data-path="icons/ui/life-buoy.svg">
    Contact the Medera team for help with implementation, BAA execution, or compliance questions
  </Card>

  <Card title="Authentication methods" icon="https://mintcdn.com/medera-357fd587/iC-6rAuwl-0aQSw_/icons/ui/lock.svg?fit=max&auto=format&n=iC-6rAuwl-0aQSw_&q=85&s=c9887b4194639a1779d01352d3348ef2" href="/authentication/overview" width="40" height="40" data-path="icons/ui/lock.svg">
    Learn how to authenticate with developer API keys, OAuth, and end-user JWT
  </Card>

  <Card title="Compliance & Trust" icon="https://mintcdn.com/medera-357fd587/n1mgcc3nR2sq_PoL/icons/ui/shield-check.svg?fit=max&auto=format&n=n1mgcc3nR2sq_PoL&q=85&s=6909d120dcab3cdfef838294f042d00c" href="/compliance/overview" width="40" height="40" data-path="icons/ui/shield-check.svg">
    Review HIPAA, 42 CFR Part 2, encryption, audit logging, and security controls
  </Card>
</Columns>

<br />

<Note>Questions about implementing Medera in your healthcare environment? [Contact us](https://medera.info/contact).</Note>
