Concepts

Understanding these concepts will help you work with the WhoWorked API effectively.

Workspaces

A workspace is the top-level container. Each workspace has its own set of projects, clients, members, and time entries. API keys are scoped to a single workspace.

Projects

Projects group related time entries together. Each project can have:

• A client — the external party the work is for.
• An hourly rate — used for billing calculations.
• Tasks — optional sub-categories within a project.
• A color — for visual identification in the UI.

Time entries

A time entry records a block of work. Key fields:

• started_at / stopped_at — the time range. If stopped_at is null, the entry is a running timer.
• description — what was done.
• project_id — which project this entry belongs to.
• task_id — optional task within the project.
• billable — whether this entry counts toward billing.

AI work sessions

Work sessions track what AI tools did for you. They capture:

• Which source (Claude, ChatGPT, Gemini, API) performed the work.
• The model used and tokens consumed.
• An estimated cost in USD.
• A summary of what was accomplished.

Tags

Tags are workspace-level labels you can attach to time entries for cross-project categorization (e.g., "meetings", "code review", "deployment").

Clients

Clients represent the external parties you work for. They can have a default hourly rate and currency. Projects are optionally linked to a client.