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
| Action | What it does |
|---|---|
| Add user to group | Make a person a member of a group. |
| Archive task | Archive a task so nobody can track time to it, or bring an archived task back. |
| Create group | Create a group to organise people into a team or department. |
| Create project | Create a project people can track time to, optionally copying another project's tasks. |
| Create task | Create a task people can track time to, in a project or on its own. |
| Delete group | Delete a group. |
| Delete project | Delete a project. |
| Get project | Get one project with its name, description and whether it's archived. |
| Get task | Get one task with its name, status and project. |
| 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. |
| Get user | Get one person in your Time Doctor company: name, email, role, time zone and when they joined. |
| Invite user | Invite someone to your Time Doctor company by email, with a role and, if you like, only some projects. |
| List groups | List the groups (teams or departments) in your Time Doctor company, with how many people each has. |
| List manual time edits | List the manual time people added or removed in a period, with the reason given and whether it was approved. |
| List projects | List projects, filtered by name. |
| List tasks | List tasks, filtered by project, name or status. |
| List users | List the people in your Time Doctor company, filtered by name, email or group. |
| Remove user from group | Take a person out of a group. |
| Update project | Rename a project or change its description. |
| Update task | Change a task's name, description, project, status or visibility. |
Add user to group
Make a person a member of a group.
Inputs
- User
member_idtextRequired - The person. Pick one, give their id from an earlier step, or type me for yourself.
- Group
group_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 ID
task_idtextRequired - The task's id, from 'List tasks', 'Create task' or an earlier step.
- Bring back instead
restoretrue/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
- Name
nametextRequired - The group's name.
- Description
descriptiontext - 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
- Name
nametextRequired - The project's name.
- Description
descriptiontext - What the project is for.
- Project
clone_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
- Name
nametextRequired - The task's name.
- Project
project_idtext - The project the task belongs to.
- Description
descriptiontext - What the task is for.
- Visible to everyone
publictrue/false - Let everyone in the company see the task. Needs an owner, admin or manager login.
- Assigned to
assigned_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
- Group
group_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
- Project
project_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
- Project
project_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 ID
task_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
- From
from_timedate and timeRequired - The start of the period to read tracked time for.
- To
to_timedate and time - The end of the period. Defaults to now. Time Doctor answers fastest for 7 days or less.
- Users
user_idslist - Whose time to read. Leave empty for your own.
- Include meetings
include_meetingstrue/false - Also include time Time Doctor detected in meetings.
- Page size
limitnumber - How many to return, 1 to 500. Defaults to 100.From 1 to 500.
- Skip
offsetnumber - 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
- User
member_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
- Email
emailtextRequired - The email address to send the invitation to.
- Name
nametext - Their full name. They can set it when they join.
- Role
roletext - What they can see and do. Defaults to user.One of:
user(User (default)),manager,admin,guest. Default:user. - Employee ID
employee_idtext - Your own id for them, such as from your HR system.
- Send invitation email
send_emailtrue/false - Turn off to invite them without Time Doctor emailing them.Default:
true. - Only these projects
project_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 groups
include_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
- From
from_timedate and timeRequired - The start of the period to read manual time edits for.
- To
to_timedate and time - The end of the period. Defaults to now. Time Doctor answers fastest for 7 days or less.
- Users
user_idslist - Whose time to read. Leave empty for your own.
- Approval
approvaltext - 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 with
nametext - Only projects whose name starts with this.
- Every project in the company
all_projectstrue/false - List every project, not only the ones you're assigned to. Needs an owner, admin or manager login.
- Order
sorttext - 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 size
limitnumber - How many to return, 1 to 500. Defaults to 100.From 1 to 500.
- Skip
offsetnumber - 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
- Project
project_idtext - Only tasks in this project.
- Name starts with
nametext - Only tasks whose name starts with this.
- Status
statustext - Only open or only closed tasks. Leave empty for both.One of:
open,closed. - Archived tasks
archivedtrue/false - List archived tasks instead of active ones.
- Order
sorttext - 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 size
limitnumber - How many to return, 1 to 500. Defaults to 100.From 1 to 500.
- Skip
offsetnumber - 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 with
nametext - Only people whose name starts with this.
- Email starts with
emailtext - Only people whose email starts with this.
- Group
group_idtext - Only people in this group.
- Include archived users
include_archivedtrue/false - Also list archived users, which are hidden by default.
- Order
sorttext - 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 size
limitnumber - How many to return, 1 to 500. Defaults to 100.From 1 to 500.
- Skip
offsetnumber - 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
- User
member_idtextRequired - The person. Pick one, give their id from an earlier step, or type me for yourself.
- Group
group_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
- Project
project_idtextRequired - The project. Pick one, or give its id from an earlier step.
- Name
nametext - A new name. Leave empty to keep it.
- Description
descriptiontext - 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 ID
task_idtextRequired - The task's id, from 'List tasks', 'Create task' or an earlier step.
- Name
nametext - A new name. Leave empty to keep it.
- Description
descriptiontext - A new description. Leave empty to keep it.
- Project
project_idtext - Move the task to this project. Leave empty to keep it.
- Status
statustext - Open or closed. Leave empty to keep it.One of:
open,closed. - Visible to everyone
publictrue/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"
}
}