Skip to main content
Use DELETE /v1/blocks/:id to permanently remove a study block from your schedule. Deleting a block only removes that single occurrence — it does not modify the subject or its weekly slot configuration.

​
Endpoint

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

​
Path Parameters

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

​
Response

Returns 204 No Content on success. The response body is empty.
Deleting a block is permanent and cannot be undone. The block will no longer appear in your schedule or statistics. Deleting a block does not affect the subject it belonged to — only this specific occurrence is removed.

​
Examples

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