Add provider_id to Bearer Login

Problem: You use a shared Bearer partner_token, but login or register fails, or Suki cannot tell which provider is active. Solution: Send provider_id on every Login and Register. Use suki_token as sdp_suki_token, and send the same id as sdp_provider_id on Ambient API calls.

This cookbook assumes Suki configured you as a Bearer partner, and that you already have your Partner ID, shared Partner Token, and agreed provider_id format.

CURL
Python
TypeScript

curl -X POST https://sdp.suki.ai/api/v1/auth/login \
  -H "Content-Type: application/json" \
  -d '{
    "partner_id": "your-partner-id",
    "partner_token": "your-shared-partner-token",
    "provider_id": "provider-123"
  }'

import requests

response = requests.post(
    "https://sdp.suki.ai/api/v1/auth/login",
    headers={"Content-Type": "application/json"},
    json={
        "partner_id": partner_id,
        "partner_token": partner_token,
        "provider_id": "provider-123",
    },
)
response.raise_for_status()
suki_token = response.json()["suki_token"]
# Use as sdp_suki_token; send provider_id as sdp_provider_id on Ambient API calls.

const response = await fetch("https://sdp.suki.ai/api/v1/auth/login", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
    partner_id: partnerId,
    partner_token: partnerToken,
    provider_id: "provider-123",
  }),
});

if (!response.ok) {
  throw new Error(`Login failed: ${response.status}`);
}

const { suki_token: sukiToken } = await response.json();
// Use as sdp_suki_token; send provider_id as sdp_provider_id on Ambient API calls.

Register (once)

CURL
Python
TypeScript

curl -X POST https://sdp.suki.ai/api/v1/auth/register \
  -H "Content-Type: application/json" \
  -d '{
    "partner_id": "your-partner-id",
    "partner_token": "your-shared-partner-token",
    "provider_id": "provider-123",
    "provider_name": "Dr. Jane Smith",
    "provider_org_id": "org-123"
  }'

import requests

response = requests.post(
    "https://sdp.suki.ai/api/v1/auth/register",
    headers={"Content-Type": "application/json"},
    json={
        "partner_id": partner_id,
        "partner_token": partner_token,
        "provider_id": "provider-123",
        "provider_name": "Dr. Jane Smith",
        "provider_org_id": "org-123",
    },
)
# New link: 201. Already linked: 409. Both are success for this flow.
if response.status_code not in (201, 409):
    response.raise_for_status()

const response = await fetch("https://sdp.suki.ai/api/v1/auth/register", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
    partner_id: partnerId,
    partner_token: partnerToken,
    provider_id: "provider-123",
    provider_name: "Dr. Jane Smith",
    provider_org_id: "org-123",
  }),
});

// New link: 201. Already linked: 409. Both are success for this flow.
if (response.status !== 201 && response.status !== 409) {
  throw new Error(`Register failed: ${response.status}`);
}

Common mistakes

For Bearer partners, provider_id is required on login and register.
Protect the shared partner_token. Send sdp_provider_id on Ambient calls after login.

Other cookbooks

AmbientAPI

Create session with emr_encounter_id.

5 min

DictationSDK

Write Dictation Text to an EHR Field

Write Dictation text with onSubmit.

5 min

​Login

​Register (once)

​Common mistakes

​Other cookbooks

​Share One Note Across Products

​Write Dictation Text to an EHR Field

Login

Register (once)

Common mistakes

Other cookbooks

Share One Note Across Products

Write Dictation Text to an EHR Field