Time Doctor

App · 20 actions

Work with Time Doctor: read tracked time and manual time edits, manage projects, tasks and groups, invite people, and start workflows when someone joins, a group is made, time is tracked or time is edited.

Actions

ActionWhat it does
Add user to groupMake a person a member of a group.
Archive taskArchive a task so nobody can track time to it, or bring an archived task back.
Create groupCreate a group to organise people into a team or department.
Create projectCreate a project people can track time to, optionally copying another project's tasks.
Create taskCreate a task people can track time to, in a project or on its own.
Delete groupDelete a group.
Delete projectDelete a project.
Get projectGet one project with its name, description and whether it's archived.
Get taskGet one task with its name, status and project.
Get tracked timeGet the time people tracked in a period: each stretch of work with its start, end, length in seconds, task and project.
Get userGet one person in your Time Doctor company: name, email, role, time zone and when they joined.
Invite userInvite someone to your Time Doctor company by email, with a role and, if you like, only some projects.
List groupsList the groups (teams or departments) in your Time Doctor company, with how many people each has.
List manual time editsList the manual time people added or removed in a period, with the reason given and whether it was approved.
List projectsList projects, filtered by name.
List tasksList tasks, filtered by project, name or status.
List usersList the people in your Time Doctor company, filtered by name, email or group.
Remove user from groupTake a person out of a group.
Update projectRename a project or change its description.
Update taskChange a task's name, description, project, status or visibility.

Add user to group

Make a person a member of a group.

Inputs

Usermember_idtextRequired
The person. Pick one, give their id from an earlier step, or type me for yourself.
Groupgroup_idtextRequired
The group. Pick one, or give its id from an earlier step.

Outputs

addedtrue/false
Always true once added
group_idtext
The group
member_idtext
The user
Example output
{
  "added": true,
  "group_id": "Yg7h8i9j0k1l2m3n",
  "member_id": "XkF1a2b3c4d5e6f7"
}

Archive task

Archive a task so nobody can track time to it, or bring an archived task back. Time Doctor never deletes tasks outright.

Inputs

Task IDtask_idtextRequired
The task's id, from 'List tasks', 'Create task' or an earlier step.
Bring back insteadrestoretrue/false
Turn on to restore an archived task instead of archiving it.

Outputs

archivedtrue/false
True if archived, false if brought back
task_idtext
The task
Example output
{
  "archived": true,
  "task_id": "Wt1u2v3w4x5y6z7a"
}

Create group

Create a group to organise people into a team or department.

Inputs

NamenametextRequired
The group's name.
Descriptiondescriptiontext
What the group is for.

Outputs

groupobject
The group
Example output
{
  "group": {
    "createdAt": "2026-11-01T09:00:00Z",
    "creatorId": "XkF1a2b3c4d5e6f7",
    "deleted": false,
    "id": "Yg7h8i9j0k1l2m3n",
    "managers": [],
    "modifiedAt": "2026-11-01T09:00:00Z",
    "name": "Design team",
    "readOnly": false,
    "users": 4
  }
}

Create project

Create a project people can track time to, optionally copying another project's tasks.

Inputs

NamenametextRequired
The project's name.
Descriptiondescriptiontext
What the project is for.
Projectclone_tasks_fromtext
Copy every task from this project into the new one.

Outputs

projectobject
The project
Example output
{
  "project": {
    "creatorId": "XkF1a2b3c4d5e6f7",
    "deleted": false,
    "description": "The new marketing site",
    "id": "Zp4q5r6s7t8u9v0w",
    "name": "Website redesign",
    "scope": "workspace",
    "weight": 0
  }
}

Create task

Create a task people can track time to, in a project or on its own.

Inputs

NamenametextRequired
The task's name.
Projectproject_idtext
The project the task belongs to.
Descriptiondescriptiontext
What the task is for.
Visible to everyonepublictrue/false
Let everyone in the company see the task. Needs an owner, admin or manager login.
Assigned toassigned_tolist
The people the task is for, which makes it private to them. Needs an owner or admin login.

Outputs

taskobject
The task
Example output
{
  "task": {
    "deleted": false,
    "description": "First pass at the layout",
    "id": "Wt1u2v3w4x5y6z7a",
    "name": "Draft the home page",
    "project": {
      "id": "Zp4q5r6s7t8u9v0w",
      "weight": 0
    },
    "public": true,
    "reporterId": "XkF1a2b3c4d5e6f7",
    "status": "open"
  }
}

Delete group

Delete a group. Its people stay in Time Doctor; only the group goes.

Inputs

Groupgroup_idtextRequired
The group. Pick one, or give its id from an earlier step.

Outputs

deletedtrue/false
Always true once deleted
group_idtext
The group deleted
Example output
{
  "deleted": true,
  "group_id": "Yg7h8i9j0k1l2m3n"
}

Delete project

Delete a project. Time already tracked to it stays in reports.

Inputs

Projectproject_idtextRequired
The project. Pick one, or give its id from an earlier step.

Outputs

deletedtrue/false
Always true once deleted
project_idtext
The project deleted
Example output
{
  "deleted": true,
  "project_id": "Zp4q5r6s7t8u9v0w"
}

Get project

Get one project with its name, description and whether it's archived.

Inputs

Projectproject_idtextRequired
The project. Pick one, or give its id from an earlier step.

Outputs

projectobject
The project
Example output
{
  "project": {
    "creatorId": "XkF1a2b3c4d5e6f7",
    "deleted": false,
    "description": "The new marketing site",
    "id": "Zp4q5r6s7t8u9v0w",
    "name": "Website redesign",
    "scope": "workspace",
    "weight": 0
  }
}

Get task

Get one task with its name, status and project.

Inputs

Task IDtask_idtextRequired
The task's id, from 'List tasks', 'Create task' or an earlier step.

Outputs

taskobject
The task
Example output
{
  "task": {
    "deleted": false,
    "description": "First pass at the layout",
    "id": "Wt1u2v3w4x5y6z7a",
    "name": "Draft the home page",
    "project": {
      "id": "Zp4q5r6s7t8u9v0w",
      "weight": 0
    },
    "public": true,
    "reporterId": "XkF1a2b3c4d5e6f7",
    "status": "open"
  }
}

Get tracked time

Get the time people tracked in a period: each stretch of work with its start, end, length in seconds, task and project. Gets one page; run it again with the next Skip value for more.

Inputs

Fromfrom_timedate and timeRequired
The start of the period to read tracked time for.
Toto_timedate and time
The end of the period. Defaults to now. Time Doctor answers fastest for 7 days or less.
Usersuser_idslist
Whose time to read. Leave empty for your own.
Include meetingsinclude_meetingstrue/false
Also include time Time Doctor detected in meetings.
Page sizelimitnumber
How many to return, 1 to 500. Defaults to 100.From 1 to 500.
Skipoffsetnumber
How many to skip, for a later page: the 'next_offset' of the page before.At least 0.

Outputs

countnumber
How many on this page
entrieslist
The stretches of tracked time
next_offsettext
The Skip value for the next page, empty on the last page
total_countnumber
How many there are in all
total_secondsnumber
The seconds tracked in this page's entries
Example output
{
  "count": 1,
  "entries": [
    {
      "deviceId": "dev-01",
      "end": "2026-11-17T15:30:00Z",
      "mode": "computer",
      "projectId": "Zp4q5r6s7t8u9v0w",
      "projectName": "Website redesign",
      "start": "2026-11-17T14:00:00Z",
      "taskId": "Wt1u2v3w4x5y6z7a",
      "taskName": "Draft the home page",
      "time": 5400,
      "userId": "XkF1a2b3c4d5e6f7"
    }
  ],
  "next_offset": "",
  "total_count": 1,
  "total_seconds": 5400
}

Get user

Get one person in your Time Doctor company: name, email, role, time zone and when they joined.

Inputs

Usermember_idtextRequired
The person. Pick one, give their id from an earlier step, or type me for yourself.

Outputs

userobject
The user
Example output
{
  "user": {
    "active": true,
    "createdAt": "2026-10-01T09:00:00Z",
    "email": "jo@example.com",
    "employeeId": "E-1001",
    "hiredAt": "2026-10-01",
    "id": "XkF1a2b3c4d5e6f7",
    "jobTitle": "Designer",
    "name": "Jo Bloggs",
    "onlyProjectIds": [],
    "role": "user",
    "status": "active",
    "timezone": "America/New_York"
  }
}

Invite user

Invite someone to your Time Doctor company by email, with a role and, if you like, only some projects. A new user may add to your Time Doctor bill.

Inputs

EmailemailtextRequired
The email address to send the invitation to.
Namenametext
Their full name. They can set it when they join.
Roleroletext
What they can see and do. Defaults to user.One of: user (User (default)), manager, admin, guest. Default: user.
Employee IDemployee_idtext
Your own id for them, such as from your HR system.
Send invitation emailsend_emailtrue/false
Turn off to invite them without Time Doctor emailing them.Default: true.
Only these projectsproject_idslist
Limit them to these projects. Leave empty for all.

Outputs

emailtext
The address invited
user_idtext
The invited user's id
Example output
{
  "email": "jo@example.com",
  "user_id": "XkF1a2b3c4d5e6f7"
}

List groups

List the groups (teams or departments) in your Time Doctor company, with how many people each has.

Inputs

Include archived groupsinclude_archivedtrue/false
Also list archived groups, which are hidden by default.

Outputs

countnumber
How many
groupslist
The groups
Example output
{
  "count": 1,
  "groups": [
    {
      "createdAt": "2026-11-01T09:00:00Z",
      "creatorId": "XkF1a2b3c4d5e6f7",
      "deleted": false,
      "id": "Yg7h8i9j0k1l2m3n",
      "managers": [],
      "modifiedAt": "2026-11-01T09:00:00Z",
      "name": "Design team",
      "readOnly": false,
      "users": 4
    }
  ]
}

List manual time edits

List the manual time people added or removed in a period, with the reason given and whether it was approved.

Inputs

Fromfrom_timedate and timeRequired
The start of the period to read manual time edits for.
Toto_timedate and time
The end of the period. Defaults to now. Time Doctor answers fastest for 7 days or less.
Usersuser_idslist
Whose time to read. Leave empty for your own.
Approvalapprovaltext
Only edits in this state. Leave empty for all.One of: pending (Waiting for approval), approved, disapproved (Rejected), autoApproved (Approved automatically).

Outputs

countnumber
How many
editslist
The time edits
Example output
{
  "count": 1,
  "edits": [
    {
      "approved": false,
      "end": "2026-11-17T10:00:00Z",
      "id": "Ed9a8b7c6d5e4f3g",
      "operation": "add",
      "projectId": "Zp4q5r6s7t8u9v0w",
      "reason": "Client call away from the computer",
      "start": "2026-11-17T09:00:00Z",
      "taskId": "Wt1u2v3w4x5y6z7a",
      "userId": "XkF1a2b3c4d5e6f7"
    }
  ]
}

List projects

List projects, filtered by name. Gets one page; run it again with the next Skip value for more.

Inputs

Name starts withnametext
Only projects whose name starts with this.
Every project in the companyall_projectstrue/false
List every project, not only the ones you're assigned to. Needs an owner, admin or manager login.
Ordersorttext
How to sort them. Defaults to name, A to Z.One of: name (Name, A to Z (default)), _name (Name, Z to A). Default: name.
Page sizelimitnumber
How many to return, 1 to 500. Defaults to 100.From 1 to 500.
Skipoffsetnumber
How many to skip, for a later page: the 'next_offset' of the page before.At least 0.

Outputs

countnumber
How many on this page
next_offsettext
The Skip value for the next page, empty on the last page
projectslist
The projects
total_countnumber
How many there are in all
Example output
{
  "count": 1,
  "next_offset": "",
  "projects": [
    {
      "creatorId": "XkF1a2b3c4d5e6f7",
      "deleted": false,
      "description": "The new marketing site",
      "id": "Zp4q5r6s7t8u9v0w",
      "name": "Website redesign",
      "scope": "workspace",
      "weight": 0
    }
  ],
  "total_count": 1
}

List tasks

List tasks, filtered by project, name or status. Gets one page; run it again with the next Skip value for more.

Inputs

Projectproject_idtext
Only tasks in this project.
Name starts withnametext
Only tasks whose name starts with this.
Statusstatustext
Only open or only closed tasks. Leave empty for both.One of: open, closed.
Archived tasksarchivedtrue/false
List archived tasks instead of active ones.
Ordersorttext
How to sort them. Defaults to name, A to Z.One of: name (Name, A to Z (default)), _name (Name, Z to A). Default: name.
Page sizelimitnumber
How many to return, 1 to 500. Defaults to 100.From 1 to 500.
Skipoffsetnumber
How many to skip, for a later page: the 'next_offset' of the page before.At least 0.

Outputs

countnumber
How many on this page
next_offsettext
The Skip value for the next page, empty on the last page
taskslist
The tasks
total_countnumber
How many there are in all
Example output
{
  "count": 1,
  "next_offset": "",
  "tasks": [
    {
      "deleted": false,
      "description": "First pass at the layout",
      "id": "Wt1u2v3w4x5y6z7a",
      "name": "Draft the home page",
      "project": {
        "id": "Zp4q5r6s7t8u9v0w",
        "weight": 0
      },
      "public": true,
      "reporterId": "XkF1a2b3c4d5e6f7",
      "status": "open"
    }
  ],
  "total_count": 1
}

List users

List the people in your Time Doctor company, filtered by name, email or group. Gets one page; run it again with the next Skip value for more.

Inputs

Name starts withnametext
Only people whose name starts with this.
Email starts withemailtext
Only people whose email starts with this.
Groupgroup_idtext
Only people in this group.
Include archived usersinclude_archivedtrue/false
Also list archived users, which are hidden by default.
Ordersorttext
How to sort them. Defaults to name, A to Z.One of: name (Name, A to Z (default)), _name (Name, Z to A), email (Email, A to Z), _created (Newest first), created (Oldest first). Default: name.
Page sizelimitnumber
How many to return, 1 to 500. Defaults to 100.From 1 to 500.
Skipoffsetnumber
How many to skip, for a later page: the 'next_offset' of the page before.At least 0.

Outputs

countnumber
How many on this page
next_offsettext
The Skip value for the next page, empty on the last page
total_countnumber
How many there are in all
userslist
The users
Example output
{
  "count": 1,
  "next_offset": "",
  "total_count": 1,
  "users": [
    {
      "active": true,
      "createdAt": "2026-10-01T09:00:00Z",
      "email": "jo@example.com",
      "employeeId": "E-1001",
      "hiredAt": "2026-10-01",
      "id": "XkF1a2b3c4d5e6f7",
      "jobTitle": "Designer",
      "name": "Jo Bloggs",
      "onlyProjectIds": [],
      "role": "user",
      "status": "active",
      "timezone": "America/New_York"
    }
  ]
}

Remove user from group

Take a person out of a group. They stay in Time Doctor.

Inputs

Usermember_idtextRequired
The person. Pick one, give their id from an earlier step, or type me for yourself.
Groupgroup_idtextRequired
The group. Pick one, or give its id from an earlier step.

Outputs

group_idtext
The group
member_idtext
The user
removedtrue/false
Always true once removed
Example output
{
  "group_id": "Yg7h8i9j0k1l2m3n",
  "member_id": "XkF1a2b3c4d5e6f7",
  "removed": true
}

Update project

Rename a project or change its description. Only the fields given change.

Inputs

Projectproject_idtextRequired
The project. Pick one, or give its id from an earlier step.
Namenametext
A new name. Leave empty to keep it.
Descriptiondescriptiontext
A new description. Leave empty to keep it.

Outputs

projectobject
The project
Example output
{
  "project": {
    "creatorId": "XkF1a2b3c4d5e6f7",
    "deleted": false,
    "description": "The new marketing site",
    "id": "Zp4q5r6s7t8u9v0w",
    "name": "Website relaunch",
    "scope": "workspace",
    "weight": 0
  }
}

Update task

Change a task's name, description, project, status or visibility. Only the fields given change.

Inputs

Task IDtask_idtextRequired
The task's id, from 'List tasks', 'Create task' or an earlier step.
Namenametext
A new name. Leave empty to keep it.
Descriptiondescriptiontext
A new description. Leave empty to keep it.
Projectproject_idtext
Move the task to this project. Leave empty to keep it.
Statusstatustext
Open or closed. Leave empty to keep it.One of: open, closed.
Visible to everyonepublictrue/false
Let everyone in the company see the task. Leave empty to keep it.

Outputs

taskobject
The task
Example output
{
  "task": {
    "deleted": false,
    "description": "First pass at the layout",
    "id": "Wt1u2v3w4x5y6z7a",
    "name": "Draft the home page",
    "project": {
      "id": "Zp4q5r6s7t8u9v0w",
      "weight": 0
    },
    "public": true,
    "reporterId": "XkF1a2b3c4d5e6f7",
    "status": "closed"
  }
}

On this page