# Take Time

## Docs

- [Create a Study Block — POST /blocks Endpoint Reference](https://docs.taketime.space/api-reference/blocks/create.md): POST /v1/blocks — create a new study block. Requires subject_id, date, start, and end. Returns the created block object with HTTP 201.
- [Delete a Study Block — DELETE /blocks/:id Reference](https://docs.taketime.space/api-reference/blocks/delete.md): DELETE /v1/blocks/:id — permanently removes a single study block. Returns 204 No Content. This does not affect the subject or its schedule.
- [List Study Blocks — GET /blocks Endpoint Reference](https://docs.taketime.space/api-reference/blocks/list.md): GET /v1/blocks — retrieve study blocks with optional filters for date, date range, subject, and completion status. Returns an array of block objects.
- [Update a Study Block — PATCH /blocks/:id Reference](https://docs.taketime.space/api-reference/blocks/update.md): PATCH /v1/blocks/:id — update fields on an existing block. Send only the fields you want to change, including marking a block as done.
- [Take Time REST API Reference — Getting Started Guide](https://docs.taketime.space/api-reference/introduction.md): The Take Time API gives programmatic access to study blocks and schedules. All endpoints use Bearer token auth and return a consistent JSON envelope.
- [Get Your Full Weekly Study Schedule — Take Time API](https://docs.taketime.space/api-reference/schedule/get.md): GET /v1/schedule — fetch your full weekly schedule with all study blocks organized by day, with support for past and future weeks via week offset.
- [AI-Powered Schedule Suggestions — Take Time REST API](https://docs.taketime.space/api-reference/schedule/suggest.md): POST /v1/schedule/suggest — get AI-powered schedule suggestions based on your completion patterns, available hours per day, and stated study goals.
- [Retrieve Study Stats and Heatmap — Take Time API](https://docs.taketime.space/api-reference/stats/get.md): Retrieve your Take Time stats including completion counts, streak days, total study minutes, and a per-day heatmap for any supported time period.
- [Create a Subject — POST /subjects Endpoint Reference](https://docs.taketime.space/api-reference/subjects/create.md): POST /v1/subjects — create a new subject profile with a name, type, optional color, and weekly time slots. Returns the created subject object.
- [Delete a Subject — DELETE /subjects/:id Endpoint Reference](https://docs.taketime.space/api-reference/subjects/delete.md): DELETE /v1/subjects/:id — permanently removes a subject and all its associated study blocks. Returns 204 No Content. This action cannot be undone.
- [List Subjects — GET /subjects Endpoint Reference Guide](https://docs.taketime.space/api-reference/subjects/list.md): GET /v1/subjects — list all your subject profiles including type, color, weekly slots, and syllabus items. Optionally filter by type.
- [Update a Subject — PATCH /subjects/:id Endpoint Reference](https://docs.taketime.space/api-reference/subjects/update.md): PATCH /v1/subjects/:id — update a subject's name, color, or weekly slots. Only the fields you include will be changed. Type changes are not supported.
- [Take Time API Authentication — Keys, Types & Rate Limits](https://docs.taketime.space/authentication.md): Authenticate Take Time API requests using Bearer token API keys. Learn about key types, how to generate keys, rate limits, and MCP Server configuration.
- [Study Blocks: Scheduling and Tracking Daily Sessions](https://docs.taketime.space/concepts/blocks.md): Study blocks are the core scheduling unit in Take Time. Each block ties a time slot to an activity, topic, and completion state on a specific date.
- [Schedule: Pizza Clock, Slots, and Daily Block Generation](https://docs.taketime.space/concepts/schedule.md): Take Time builds your daily blocks from weekly slot profiles. Learn how the pizza clock view, slot conflicts, and auto-generation work.
- [Progress Stats: Heatmaps, Streaks, and Completion Rate](https://docs.taketime.space/concepts/stats.md): Take Time tracks your study completions with a 12-month heatmap, streak counters, and completion rate metrics. Learn what each metric measures.
- [Activities: Study, Training, and Routine Subject Profiles](https://docs.taketime.space/concepts/subjects.md): Activities (called subjects in the API) are named profiles for what you study, train, or practice — each with its own content and weekly schedule.
- [Integrate Take Time Data into Your Tools and Workflows](https://docs.taketime.space/guides/api-integration.md): Use the Take Time REST API to sync your study schedule with external tools, automate block creation, and pull progress data into your own dashboards.
- [Test Your Integration Safely with Take Time Sandbox Mode](https://docs.taketime.space/guides/dev-mode.md): Use Take Time sandbox (tt_test_) API keys during development. Test keys give you full API access without affecting your real study data or streak.
- [Using the Take Time App: Your Complete Setup Guide](https://docs.taketime.space/guides/using-the-app.md): Learn how to install Take Time, create activities, build your weekly schedule, complete study blocks, and track your progress over time.
- [Welcome to Take Time — Study Planner API & MCP](https://docs.taketime.space/introduction.md): Take Time is a personal study planner PWA with a REST API and MCP Server. Manage your schedule, subjects, and progress with code or AI.
- [Take Time MCP Examples — Natural Language Prompts](https://docs.taketime.space/mcp/examples.md): Practical natural-language prompt examples for managing your Take Time schedule with Claude, Cursor, or any MCP-compatible AI assistant.
- [Install the Take Time MCP Server for Claude and Cursor](https://docs.taketime.space/mcp/installation.md): Set up the Take Time MCP Server for Claude Desktop, Cursor, or VS Code in minutes. Requires Node.js 18+ and a Take Time API key to get started.
- [Take Time MCP Server — Overview and Supported Clients](https://docs.taketime.space/mcp/overview.md): The Take Time MCP Server lets AI assistants read and manage your study schedule using natural language via the Model Context Protocol standard.
- [Take Time MCP Tools — Full Parameter and Return Reference](https://docs.taketime.space/mcp/tools.md): Complete reference for all 9 Take Time MCP tools — parameters, types, required fields, and return shapes for every read, write, and delete tool.
- [Take Time API Quickstart — First Call in 5 Minutes](https://docs.taketime.space/quickstart.md): Learn how to authenticate, list your study blocks, and create your first block with the Take Time REST API. Copy-paste examples in cURL, Node.js, and Python.