Skip to main content
An activity (referred to as a subject in the API) is a named profile representing something you want to spend time on. Each activity has a type — Study, Training, or Routine — which controls what kind of content it tracks and how blocks appear when you open them.

Subject Fields

Every activity you create is stored as a subject object with the following fields:
FieldTypeDescription
idstringUnique identifier
namestringDisplay name (max 40 characters)
typestringProfile type: study, training, or inactive
colorstringHex color code used in the schedule and heatmap
slotsarrayWeekly time slots assigned to this activity
No two activities can share the same name. Take Time enforces this uniqueness constraint at the point of creation and when you rename an existing activity. If you try to save a duplicate name, the app will prompt you to choose a different one.
Color is assigned automatically if you do not specify one when creating an activity. You can change it at any time from the activity’s profile screen.

Profile Types

The type you choose when creating an activity determines what content it tracks and how its blocks behave.
TypeAPI valueContent tracked
StudystudySyllabus topics with estimated durations
TrainingtrainingExercise sheet with sets / reps / weight
RoutineinactiveMicro-habits checklist

Study

Build a syllabus of topics with estimated durations. When you open a Study block, you pick the topic you are covering from this list. Topics track their own completion state so you can follow your progress through course material.

Training

Define an exercise sheet with names, sets, reps, and weights. Training blocks display this sheet as a checklist so you can log each exercise as you finish it.

Routine

Create a list of micro-habits — short actions you want to perform consistently. Routine blocks surface these as a quick checklist to tick off during the session.

Content by Profile Type

Study — Syllabus Topics

Each topic in a Study subject’s syllabus carries three properties:
FieldTypeDescription
titlestringName of the topic or chapter
durationnumberEstimated time in minutes
donebooleanWhether you have covered this topic
Keep individual syllabus topics to 50 minutes or less. Shorter cycles fit neatly into a single block, make it easier to pick up exactly where you left off, and give you more frequent completion moments — which keeps your heatmap active and your streak alive.

Training — Exercise Sheet

Each entry on a Training subject’s exercise sheet includes:
FieldTypeDescription
namestringExercise name
setsnumberNumber of sets
repsnumberRepetitions per set
weightnumberLoad in your preferred unit

Routine — Micro-Habits

Routine subjects hold a simple list of habit strings:
FieldTypeDescription
titlestringDescription of the habit to perform
Add as many micro-habits as your routine requires. Each one appears as its own checkbox inside a Routine block.

Weekly Slots

Each activity can hold one or more weekly slot definitions. A slot tells Take Time which days of the week and what time range that activity should run.
{
  "days": [1, 3, 5],
  "start": "09:00",
  "end": "10:00"
}
Days are represented as integers where 0 = Sunday and 6 = Saturday. The example above schedules the activity on Monday, Wednesday, and Friday from 09:00 to 10:00. Take Time uses these slot profiles to auto-generate blocks each day. You can add multiple slots to the same activity — for instance, a short morning slot and a longer evening slot — as long as they do not conflict with slots belonging to other activities on the same days.

Priority Circle

The Priority Circle lets you sort your activities into three tiers so you can see at a glance where your time should go.
ZoneLabelPurpose
zone1Main FocusActivities that are your top priority right now
zone2ImportantActivities that matter but are secondary
zone3FlexibleActivities you fit in when you have spare time
UnallocatedActivities not yet assigned to any zone
Drag any activity card into a zone on the Priority Circle screen. You can reassign activities between zones at any time. Unallocated activities still appear on your schedule normally — the circle is a planning aid, not a gate.