Skip to main content
Use this endpoint to permanently remove a consent record. Deletion is irreversible. For most clinical workflows, it is preferable to revoke a consent by updating its status to inactive, which preserves the audit trail while preventing the consent from being treated as active.

​
Request

DELETE https://api.clinikapi.com/v1/consents/: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 consent to delete (e.g. consent_abc123).

​
Response

Returns 204 No Content with an empty body on success.
​
meta
object
Standard response metadata including requestId, timestamp, and rate-limit fields.

​
Examples

​
curl

curl -X DELETE https://api.clinikapi.com/v1/consents/consent_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.consents.delete('consent_abc123');