latestOpenAPI 3.1.02026-08-194237902.5 MB

563848e0ecc0

Specialty

Permanently delete a specialty record

Permanently removes the specialty record with the given ID from the tenant's catalog. This action is irreversible.

When to use: Use this endpoint to remove a specialty that is no longer needed. Deleting a specialty does not cascade to any other record: it does not remove or modify tenant, practitioner, group, or facility associations that reference it. If any such association still references the specialty, the deletion is rejected (409) rather than leaving those associations dangling.

Preconditions: Requires the DELETE_SPECIALTY permission. The tenant-id header must be supplied. id must refer to an existing specialty for the tenant; if it does not, 404 is returned.

Result: Returns 204 with no response body on success — a single, synchronous operation with no other side effects. Not idempotent — deleting an already-deleted specialty returns 404, not 204.

delete/specialties/{id}

Path parameters

idstring required

ID of the specialty to delete (server-assigned UUID-format string).

Headers

tenant-idstring required

Response

The specialty was deleted. No response body.