Skip to main content
Use this endpoint to permanently remove a structured clinical document from your tenant. This action cannot be undone. For finalized documents, consider updating status to amended and adding an addendum section to retract the content without losing the audit trail.

​
Request

DELETE https://api.clinikapi.com/v1/documents/: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 document to delete (e.g. doc_abc123).

​
Response

Returns 204 No Content with an empty body on success. If the document 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/documents/doc_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.documents.delete('doc_abc123');
// Resolves with no return value on success (204 No Content)