> ## 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 Subject — DELETE /subjects/:id Endpoint Reference

> DELETE /v1/subjects/:id — permanently removes a subject and all its associated study blocks. Returns 204 No Content. This action cannot be undone.

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

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

## Response

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

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

## Examples

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

  ```javascript Node.js theme={null}
  const response = await fetch('https://api.taketime.app/v1/subjects/sub_xyz', {
    method: 'DELETE',
    headers: {
      'Authorization': 'Bearer tt_live_your_key_here',
    },
  });

  if (response.status === 204) {
    console.log('Subject deleted successfully');
  } else {
    const { error } = await response.json();
    console.error('Failed to delete subject:', error.code, error.message);
  }
  ```
</CodeGroup>

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