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

# Integration Paths Overview

> Suki for Partners offers Ambient, Dictation, and Form filling workflows. Learn more about each workflow and how to choose the right one for your use case

With Suki for Partners, you can create Ambient, Dictation, and Form filling workflows. Choose the APIs or SDKs integration paths that best fit your application type, stack, and how much user interface you want to own.

## Choose your integration path

<Card title="Ambient Workflows & Use Cases" icon="waveform">
  Use ambient workflows to add ambient clinical intelligence to your application for doctor-patient conversations.

  <CardGroup cols={2}>
    <Card title="Ambient APIs" icon="code" href="/documentation/integration-decision-guide#ambient-apis" arrow={true}>
      <Badge size="sm" color="blue" icon="code">REST</Badge> | <Badge size="sm" color="green" icon="globe">WebSocket</Badge> | <Badge size="sm" color="orange" icon="webhook">Webhooks</Badge>
    </Card>

    <Card title="Web SDK" icon="globe" href="/documentation/integration-decision-guide#web-sdk" arrow={true}>
      <Badge size="sm" color="blue" icon="code">JavaScript</Badge> | <Badge size="sm" color="green" icon="react">React</Badge> | <Badge size="sm" color="gray" icon="desktop">Headed</Badge>
    </Card>

    <Card title="Mobile SDK" icon="mobile" href="/documentation/integration-decision-guide#mobile-sdk" arrow={true}>
      <Badge size="sm" color="purple" icon="apple">iOS</Badge> | <Badge size="sm" color="orange" icon="swift">Swift</Badge>
    </Card>

    <Card title="Headless Web SDK" icon="react" href="/documentation/integration-decision-guide#headless-web-sdk" arrow={true}>
      <Badge size="sm" color="blue" icon="react">React</Badge> | <Badge size="sm" color="gray" icon="react">Headless</Badge>
    </Card>

    <Card title="Dictation SDK" icon="microphone" href="/documentation/integration-decision-guide#dictation" arrow={true}>
      <Badge size="sm" color="orange" icon="code">JavaScript</Badge> | <Badge size="sm" color="green" icon="react">React</Badge>
    </Card>
  </CardGroup>
</Card>

<Card title="Form Filling Workflows & Use Cases" icon="file-lines">
  Use Form filling workflows for ambient clinical documentation for nursing and other clinical workflows.

  <CardGroup cols={2}>
    <Card title="Form Filling REST APIs" icon="code" href="/documentation/form-filling-integration-decision-guide#form-filling-apis" arrow={true}>
      <Badge size="sm" color="blue" icon="code">REST</Badge> | <Badge size="sm" color="green" icon="globe">WebSocket</Badge> | <Badge size="sm" color="orange" icon="webhook">Webhooks</Badge>
    </Card>
  </CardGroup>
</Card>

## What should I use?

| Area              | Direct API calls (REST/WebSocket/Webhooks)                          | SDKs (Web SDK, Headless Web SDK, Mobile SDK, Dictation SDK)                                       |
| ----------------- | ------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------- |
| Authentication    | Build token exchange, storage, headers, and refresh logic.          | SDK-managed auth setup and token use.                                                             |
| Session lifecycle | Call create, update, status, and end endpoints directly.            | SDK methods or hooks for common session actions.                                                  |
| Audio streaming   | Manage WebSocket connections, audio chunks, events, and reconnects. | Managed recording, streaming, and session events.                                                 |
| UI                | Build every screen, control, and workflow state.                    | Web SDK includes UI; Headless Web SDK, Mobile SDK, and Dictation SDK handle integration behavior. |
| Type safety       | Validate request and response data in your code.                    | Typed methods, options, and events.                                                               |
| Error handling    | Parse HTTP status codes, error bodies, and WebSocket failures.      | SDK errors and events expose structured failure details.                                          |
| Platform fit      | Any client, backend, or multi-platform architecture.                | Supported web, React, iOS, and dictation workflows.                                               |
| Control           | Maximum control over protocol behavior.                             | Less protocol code for supported integrations.                                                    |