Registers a user.
Copy
Ask AI
curl --request POST \
--url https://sdp.suki-stage.com/api/v1/auth/register \
--header 'Content-Type: application/json' \
--data '
{
"partner_id": "your-partner-id",
"partner_token": "eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9...",
"provider_id": "provider-123",
"provider_name": "Dr. John Smith",
"provider_org_id": "org-123",
"provider_specialty": "CARDIOLOGY"
}
'Copy
Ask AI
This response has no body data.Authentication
Register
Register new healthcare provider or link existing provider to partner organization
POST
/
api
/
v1
/
auth
/
register
Registers a user.
Copy
Ask AI
curl --request POST \
--url https://sdp.suki-stage.com/api/v1/auth/register \
--header 'Content-Type: application/json' \
--data '
{
"partner_id": "your-partner-id",
"partner_token": "eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9...",
"provider_id": "provider-123",
"provider_name": "Dr. John Smith",
"provider_org_id": "org-123",
"provider_specialty": "CARDIOLOGY"
}
'Copy
Ask AI
This response has no body data.Use this endpoint to register a new healthcare provider in the Suki platform or to link an existing provider to a new partner-organization relationship.
This is a one-time setup call for each provider within an organization.
Registration Scenarios
This endpoint handles three different scenarios depending on the user’s status in the Suki system.| Scenario | Condition | Actions Taken | Response |
|---|---|---|---|
| New User | The provider does not exist in Suki. | • Creates a new organization • Links your partner account to the organization • Creates a new user with the provided details | 201 Created |
| Existing User, New Link | The provider exists but is not yet linked to your partner account. | • Verifies the user and organization details • Links your partner account to the existing organization | 201 Created |
| Existing User, Already Linked | The provider and organization are already linked to your partner account. | • Detects the existing link | 409 Conflict |
Code Examples
- Python
- TypeScript
Copy
Ask AI
import requests
url = "https://sdp.suki.ai/api/v1/auth/register"
payload = {
"partner_id": "your-partner-id",
"partner_token": "eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9...",
"provider_name": "Dr. John Smith",
"provider_org_id": "org-123",
"provider_id": "provider-123", # Optional
"provider_specialty": "CARDIOLOGY" # Optional, defaults to FAMILY_MEDICINE
}
response = requests.post(url, json=payload)
if response.status_code == 201:
print("Provider registered successfully")
elif response.status_code == 409:
print("Provider already linked to this partner")
else:
print(f"Registration failed: {response.status_code}")
print(response.json())
Copy
Ask AI
const response = await fetch('https://sdp.suki.ai/api/v1/auth/register', {
method: 'POST',
headers: {
'Content-Type': 'application/json'
},
body: JSON.stringify({
partner_id: 'your-partner-id',
partner_token: 'eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9...',
provider_name: 'Dr. John Smith',
provider_org_id: 'org-123',
provider_id: 'provider-123', // Optional
provider_specialty: 'CARDIOLOGY' // Optional, defaults to FAMILY_MEDICINE
})
});
if (response.status === 201) {
console.log('Provider registered successfully');
} else if (response.status === 409) {
console.log('Provider already linked to this partner');
} else {
const error = await response.json();
console.error(`Registration failed: ${response.status}`, error);
}
Body
application/json
RegistrationRequest
Request body for the /auth/register endpoint
Unique identifier for the partner. This will be shared securely by Suki to the partner through a separate partner registration process.
Example:
"your-partner-id"
JWT token issued by trusted authorization server. The token must include Provider Email.
Example:
"eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9..."
Name of the provider.
Example:
"Dr. John Smith"
Health system or organization to which the provider belongs.
Example:
"org-123"
Optional - Unique identifier for the provider. This is required for Bearer type partners only and will be ignored for other partner types. This must match a pre-defined expression.
Example:
"provider-123"
Optional - Medical specialty of the provider. Defaults to FAMILY_MEDICINE if not provided.
Example:
"CARDIOLOGY"
Response
⌘I