# Delete a study block

Source: https://workroad.app/docs/api/delete-study-block

`DELETE https://workroad.app/api/v1/study-blocks/{studyBlockId}`

Removes a planned block from the user's calendar.

- MCP tool: `deleteStudyBlock` on `https://workroad.app/api/mcp`
- Required scopes: schedule:delete
- Test mode: `DELETE https://workroad.app/api/test/v1/study-blocks/{studyBlockId}` checks the request and returns the example response without changing anything.

## Path parameters

- `studyBlockId`: string (uuid), required. Study block id, scoped to the key's user.

## Response

`200` OK

- `data`: object, required
  - `id`: string (uuid), required
  - `deleted`: `true`, required

### Example

```json
{
  "data": {
    "id": "5a4b3c2d-1e0f-4a9b-8c7d-6e5f4a3b2c1d",
    "deleted": true
  }
}
```

## Errors

Every error has the body `{ "error": { "code", "message", "details" } }`.

- `400`: Invalid request body or query
- `401`: Missing, invalid, disabled or expired API key
- `403`: The API key lacks the required scope
- `404`: No study block with that id exists for this key's user.
- `405`: Method not allowed. Use a method from the Allow header.
- `429`: Rate limit exceeded. Wait for Retry-After before retrying. The rate-limit headers are absent when the key's own limiter rejected the request before the per-endpoint bucket check ran.
- `500`: Internal server error