Skip to main content
Use this endpoint to update a practitioner’s details. Send only the fields you want to change — all other fields remain as-is. The response returns the complete updated practitioner.

​
Request

PATCH https://api.clinikapi.com/v1/practitioners/{id}

​
Headers

​
x-api-key
string
required
Your ClinikAPI secret key (clk_live_* or clk_test_*).
​
Content-Type
string
required
Must be application/json.

​
Path Parameters

​
id
string
required
The ID of the practitioner to update (e.g. prac_xyz789).

​
Body

Provide any subset of the practitioner fields you want to update. All fields are optional.
​
firstName
string
Updated first name.
​
lastName
string
Updated last name.
​
prefix
string[]
Updated name prefixes.
​
suffix
string[]
Updated name suffixes.
​
email
string
Updated email address.
​
phone
string
Updated phone number.
​
npi
string
Updated National Provider Identifier.
​
specialty
string
Updated primary specialty.
​
qualifications
array
Updated qualifications list. Replaces the entire qualifications array.
​
languages
string[]
Updated BCP-47 language codes.
​
address
object
Updated address. Replaces the entire address object.

​
Response

Returns 200 OK with the complete updated practitioner resource.
​
data.id
string
The practitioner’s unique ID.
​
data.specialty
string
The practitioner’s current specialty.
​
meta
object
Standard response metadata.

​
Examples

​
curl

curl -X PATCH https://api.clinikapi.com/v1/practitioners/prac_xyz789 \
  -H "x-api-key: clk_live_abc123" \
  -H "Content-Type: application/json" \
  -d '{
    "specialty": "Interventional Cardiology",
    "phone": "+1-555-0201"
  }'

​
TypeScript SDK

import { ClinikAPI } from "@clinikapi/sdk";

const client = new ClinikAPI({ apiKey: "clk_live_abc123" });

const updated = await client.practitioners.update("prac_xyz789", {
  specialty: "Interventional Cardiology",
  phone: "+1-555-0201",
});

console.log(updated.data.specialty); // "Interventional Cardiology"