> ## 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.

# User Preferences API

> Read and update end-user preferences for the Suki platform

The User Preferences APIs enable partners to read and update preferences for the authenticated provider so your client stays aligned with Suki user-scoped settings. Typical preferences include language, layout, or other defaults exposed by the API for that user.

These APIs are called from your servers and authenticated with a Suki Token (`sdp_suki_token`). Critically, preferences are scoped to the authenticated provider. They do not replace organization-level Partner configuration.

## Available endpoints

<Columns cols={1}>
  <Card title="User Preferences" href="/api-reference/user-preferences/preferences" arrow={true} icon="code">
    Read or update preferences for the authenticated provider
  </Card>
</Columns>

## Related guides

<Columns cols={2}>
  <Card title="Partner Authentication" href="/documentation/how-to/partner-authentication" icon="book" cta="Learn more">
    Set up Partner Tokens before you call authenticated Partner APIs
  </Card>

  <Card title="Ambient Documentation" href="/documentation/concepts/ambient-clinical-notes/ambient-documentation" icon="book" cta="Learn more">
    See how authenticated ambient workflows fit into clinical documentation
  </Card>
</Columns>

## Common use cases

<Columns cols={2}>
  <Card title="Personalize note style per clinician">
    Save verbosity and section format preferences so future ambient notes match how each clinician documents.
  </Card>

  <Card title="Expose note-style settings in your product">
    Let clinicians change documentation preferences in your UI so later ambient sessions pick up those settings automatically.
  </Card>
</Columns>