Skip to main content
Use DELETE /v1/subjects/:id to permanently remove a subject and all study blocks associated with it. This is a destructive action — all past and future blocks for this subject will be deleted along with the subject profile itself.

​
Endpoint

DELETE https://api.taketime.app/v1/subjects/:id

​
Path Parameters

​
id
string
required
The unique identifier of the subject you want to delete.

​
Response

Returns 204 No Content on success. The response body is empty.
Deleting a subject permanently removes the subject profile and every study block associated with it — including completed historical blocks and all future scheduled occurrences. This action cannot be undone. If you only want to stop scheduling new blocks, consider updating the subject’s slots to an empty array instead.

​
Examples

curl -X DELETE https://api.taketime.app/v1/subjects/sub_xyz \
  -H "Authorization: Bearer tt_live_your_key_here"
A 204 response has no body. Check the HTTP status code to confirm the deletion was successful rather than attempting to parse a response body.