> ## Documentation Index
> Fetch the complete documentation index at: https://docs.taketime.space/llms.txt
> Use this file to discover all available pages before exploring further.

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

> DELETE /v1/blocks/:id — permanently removes a single study block. Returns 204 No Content. This does not affect the subject or its schedule.

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

<ParamField path="id" type="string" required>
  The unique identifier of the study block you want to delete.
</ParamField>

## Response

Returns `204 No Content` on success. The response body is empty.

<Warning>
  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.
</Warning>

## Examples

<CodeGroup>
  ```bash cURL theme={null}
  curl -X DELETE https://api.taketime.app/v1/blocks/blk_abc123 \
    -H "Authorization: Bearer tt_live_your_key_here"
  ```

  ```javascript Node.js theme={null}
  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);
  }
  ```
</CodeGroup>

<Note>
  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.
</Note>