Skip to main content
Use this endpoint to permanently remove a clinical assessment from your tenant. Deletion is irreversible. If you want to invalidate an assessment without losing the record, consider updating its status to reflect the correct state rather than deleting it outright.

​
Request

DELETE https://api.clinikapi.com/v1/assessments/: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 assessment to delete (e.g. assess_abc123).

​
Response

Returns 204 No Content with an empty body on success. If the assessment 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/assessments/assess_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.assessments.delete('assess_abc123');
// Resolves with no return value on success (204 No Content)