Delete a Study Block — DELETE /blocks/:id Reference

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

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"

const response = await fetch('https://api.taketime.app/v1/blocks/blk_abc123', {
  method: 'DELETE',
  headers: {
    'Authorization': 'Bearer tt_live_your_key_here',
  },
});

if (response.status === 204) {
  console.log('Block deleted successfully');
} else {
  const { error } = await response.json();
  console.error('Failed to delete block:', error.code, error.message);
}

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.

Update a Study Block — PATCH /blocks/:id Reference

List Subjects — GET /subjects Endpoint Reference Guide

Overview

Blocks

Subjects

Stats & Schedule

Delete a Study Block — DELETE /blocks/:id Reference

Endpoint

Path Parameters

Response

Examples

​Endpoint

​Path Parameters

​Response

​Examples

Endpoint

Path Parameters

Response

Examples