Skip to main content
Use this endpoint to permanently remove a practitioner role record. The operation is irreversible — once deleted, the role cannot be recovered through the API. If you want to temporarily disable a role without removing it, consider setting status to inactive using the update endpoint instead.

​
Request

DELETE https://api.clinikapi.com/v1/practitioner-roles/{id}

​
Headers

​
x-api-key
string
required
Your ClinikAPI secret key (clk_live_* or clk_test_*).

​
Path Parameters

​
id
string
required
The ID of the practitioner role to delete (e.g. pr_abc123).

​
Response

Returns 204 No Content with an empty body on success. If the practitioner role does not exist or does not belong to your tenant, the API returns 404 Not Found.

​
Examples

​
curl

curl -X DELETE https://api.clinikapi.com/v1/practitioner-roles/pr_abc123 \
  -H "x-api-key: clk_live_abc123"

​
TypeScript SDK

import { Clinik } from '@clinikapi/sdk';

const clinik = new Clinik(process.env.CLINIKAPI_SECRET_KEY!);

await clinik.practitionerRoles.delete('pr_abc123');
// Resolves with no value on success (204)