The account behind the API key: name, email, active workspace, time zone, and how this server is configured (workspace lock, read-only). Start here when anything looks wrong.

Every workspace the API key can see. Refused when the server is locked to one.

Full workspace record: settings, features, currencies and your membership in it.

People in the workspace, with their ids — needed whenever a tool asks for user_id.

Resolves a person to their Clockify id from a name or an email fragment, so a request like "what did Anna work on" does not need ids typed by hand.

Teams defined in the workspace, with their member ids.

The timer running right now, with how long it has been going. Returns nothing when the clock is stopped.

Starts the clock. Clockify keeps one running timer per user, so this stops an already running one first.

Stops the running timer and returns the finished entry with its duration.

Writes a completed time entry. Times are local to the account's zone, so "yesterday 09:00 for 2h30m" lands where a person expects it to.

Writes several finished entries in one call — a full workday reconstructed from notes or commits. Each entry reports its own result, so one bad line does not lose the rest.

Time entries for a person over a day or a range, newest first, with a total. Without any date arguments it returns today.

Totals per project, task, day or tag for a period — computed from the entries themselves, so it also works on the free plan, where the Reports API is not available.

One time entry in full, with its project, task and tags resolved.

Changes description, project, tags or times. Clockify replaces the whole entry on update, so the current values are read first and only the given fields change.

Removes a time entry permanently. Requires confirm: true.

Projects in the workspace, with their ids, clients and archived state.

Looks a project up by name and returns the candidates with their ids — the quickest way from what a person calls a project to what the API needs.

One project in full: client, estimates, memberships, hourly rate.

Adds a project to the workspace.

Renames, re-colours, archives or restores a project.

Deletes a project. Clockify only allows this once the project is archived, so archive it first.

Clients in the workspace.

Adds a client to the workspace.

Renames or archives a client.

Removes a client.

Tasks of a project, with their ids and status.

One task in full.

Adds a task to a project.

Renames a task, reassigns it or marks it done.

Removes a task from a project.

Tags defined in the workspace.

Adds a tag to the workspace.

Renames or archives a tag.

Removes a tag.

Sends a workspace invitation. Needs admin rights and a free seat.

Changes a member's status in the workspace without deleting their history.

Removes someone from the workspace. Their time entries stay.

Adds a team to the workspace.

Renames a team.

Puts someone into a team.

Takes someone out of a team.

Removes a team.

Totals grouped the way the Clockify summary report groups them, for the whole workspace. Needs a paid plan; on the free plan use clockify_time_summary instead.

Every time entry in the range across the workspace, one row each. Needs a paid plan.

The weekly grid: rows per project or person, columns per day. Needs a paid plan.

Public and company holidays configured in the workspace.

Adds a holiday to the workspace calendar.

Removes a holiday.

Vacation, sick leave and other policies, with the ids a request needs.

How many days are left under each policy for a person.

Requests in the workspace — pending ones are what an approver looks for.

Files a time-off request against a policy.

Submitted timesheets awaiting approval. Needs a paid plan.

Submits your week for approval. Needs a paid plan.

Custom fields defined on the workspace. Needs a paid plan.

Expenses recorded in the workspace. Needs a paid plan.

Records an expense. Needs a paid plan.

Invoices in the workspace. Needs a paid plan.

Webhooks registered on the workspace. Needs a paid plan.

Any Clockify endpoint that has no dedicated tool. Paths are relative to the API root; pick surface to reach the reports or time-off hosts. Respects read-only mode and the workspace lock.