# Time Doctor

> 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.

App · 20 actions. Web page: https://docs.lodol.com/docs/integrations/time-doctor

## Actions

### Add user to group

Make a person a member of a group.

**Inputs**

- User (`member_id`, text, required): The person. Pick one, give their id from an earlier step, or type me for yourself.
- Group (`group_id`, text, required): The group. Pick one, or give its id from an earlier step.

**Outputs**

- `added` (true/false): Always true once added
- `group_id` (text): The group
- `member_id` (text): The user

**Example output**

```json
{
  "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_id`, text, required): The task's id, from 'List tasks', 'Create task' or an earlier step.
- Bring back instead (`restore`, true/false): Turn on to restore an archived task instead of archiving it.

**Outputs**

- `archived` (true/false): True if archived, false if brought back
- `task_id` (text): The task

**Example output**

```json
{
  "archived": true,
  "task_id": "Wt1u2v3w4x5y6z7a"
}
```

### Create group

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

**Inputs**

- Name (`name`, text, required): The group's name.
- Description (`description`, text): What the group is for.

**Outputs**

- `group` (object): The group

**Example output**

```json
{
  "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 (`name`, text, required): The project's name.
- Description (`description`, text): What the project is for.
- Project (`clone_tasks_from`, text): Copy every task from this project into the new one.

**Outputs**

- `project` (object): The project

**Example output**

```json
{
  "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 (`name`, text, required): The task's name.
- Project (`project_id`, text): The project the task belongs to.
- Description (`description`, text): What the task is for.
- Visible to everyone (`public`, true/false): Let everyone in the company see the task. Needs an owner, admin or manager login.
- Assigned to (`assigned_to`, list): The people the task is for, which makes it private to them. Needs an owner or admin login.

**Outputs**

- `task` (object): The task

**Example output**

```json
{
  "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_id`, text, required): The group. Pick one, or give its id from an earlier step.

**Outputs**

- `deleted` (true/false): Always true once deleted
- `group_id` (text): The group deleted

**Example output**

```json
{
  "deleted": true,
  "group_id": "Yg7h8i9j0k1l2m3n"
}
```

### Delete project

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

**Inputs**

- Project (`project_id`, text, required): The project. Pick one, or give its id from an earlier step.

**Outputs**

- `deleted` (true/false): Always true once deleted
- `project_id` (text): The project deleted

**Example output**

```json
{
  "deleted": true,
  "project_id": "Zp4q5r6s7t8u9v0w"
}
```

### Get project

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

**Inputs**

- Project (`project_id`, text, required): The project. Pick one, or give its id from an earlier step.

**Outputs**

- `project` (object): The project

**Example output**

```json
{
  "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_id`, text, required): The task's id, from 'List tasks', 'Create task' or an earlier step.

**Outputs**

- `task` (object): The task

**Example output**

```json
{
  "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_time`, date and time, required): The start of the period to read tracked time for.
- To (`to_time`, date and time): The end of the period. Defaults to now. Time Doctor answers fastest for 7 days or less.
- Users (`user_ids`, list): Whose time to read. Leave empty for your own.
- Include meetings (`include_meetings`, true/false): Also include time Time Doctor detected in meetings.
- Page size (`limit`, number): How many to return, 1 to 500. Defaults to 100. From 1 to 500.
- Skip (`offset`, number): How many to skip, for a later page: the 'next_offset' of the page before. At least 0.

**Outputs**

- `count` (number): How many on this page
- `entries` (list): The stretches of tracked time
- `next_offset` (text): The Skip value for the next page, empty on the last page
- `total_count` (number): How many there are in all
- `total_seconds` (number): The seconds tracked in this page's entries

**Example output**

```json
{
  "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_id`, text, required): The person. Pick one, give their id from an earlier step, or type me for yourself.

**Outputs**

- `user` (object): The user

**Example output**

```json
{
  "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 (`email`, text, required): The email address to send the invitation to.
- Name (`name`, text): Their full name. They can set it when they join.
- Role (`role`, text): What they can see and do. Defaults to user. One of: `user` (User (default)), `manager`, `admin`, `guest`. Default: `user`.
- Employee ID (`employee_id`, text): Your own id for them, such as from your HR system.
- Send invitation email (`send_email`, true/false): Turn off to invite them without Time Doctor emailing them. Default: `true`.
- Only these projects (`project_ids`, list): Limit them to these projects. Leave empty for all.

**Outputs**

- `email` (text): The address invited
- `user_id` (text): The invited user's id

**Example output**

```json
{
  "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_archived`, true/false): Also list archived groups, which are hidden by default.

**Outputs**

- `count` (number): How many
- `groups` (list): The groups

**Example output**

```json
{
  "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_time`, date and time, required): The start of the period to read manual time edits for.
- To (`to_time`, date and time): The end of the period. Defaults to now. Time Doctor answers fastest for 7 days or less.
- Users (`user_ids`, list): Whose time to read. Leave empty for your own.
- Approval (`approval`, text): Only edits in this state. Leave empty for all. One of: `pending` (Waiting for approval), `approved`, `disapproved` (Rejected), `autoApproved` (Approved automatically).

**Outputs**

- `count` (number): How many
- `edits` (list): The time edits

**Example output**

```json
{
  "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 (`name`, text): Only projects whose name starts with this.
- Every project in the company (`all_projects`, true/false): List every project, not only the ones you're assigned to. Needs an owner, admin or manager login.
- Order (`sort`, text): 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 (`limit`, number): How many to return, 1 to 500. Defaults to 100. From 1 to 500.
- Skip (`offset`, number): How many to skip, for a later page: the 'next_offset' of the page before. At least 0.

**Outputs**

- `count` (number): How many on this page
- `next_offset` (text): The Skip value for the next page, empty on the last page
- `projects` (list): The projects
- `total_count` (number): How many there are in all

**Example output**

```json
{
  "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_id`, text): Only tasks in this project.
- Name starts with (`name`, text): Only tasks whose name starts with this.
- Status (`status`, text): Only open or only closed tasks. Leave empty for both. One of: `open`, `closed`.
- Archived tasks (`archived`, true/false): List archived tasks instead of active ones.
- Order (`sort`, text): 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 (`limit`, number): How many to return, 1 to 500. Defaults to 100. From 1 to 500.
- Skip (`offset`, number): How many to skip, for a later page: the 'next_offset' of the page before. At least 0.

**Outputs**

- `count` (number): How many on this page
- `next_offset` (text): The Skip value for the next page, empty on the last page
- `tasks` (list): The tasks
- `total_count` (number): How many there are in all

**Example output**

```json
{
  "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 (`name`, text): Only people whose name starts with this.
- Email starts with (`email`, text): Only people whose email starts with this.
- Group (`group_id`, text): Only people in this group.
- Include archived users (`include_archived`, true/false): Also list archived users, which are hidden by default.
- Order (`sort`, text): 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 (`limit`, number): How many to return, 1 to 500. Defaults to 100. From 1 to 500.
- Skip (`offset`, number): How many to skip, for a later page: the 'next_offset' of the page before. At least 0.

**Outputs**

- `count` (number): How many on this page
- `next_offset` (text): The Skip value for the next page, empty on the last page
- `total_count` (number): How many there are in all
- `users` (list): The users

**Example output**

```json
{
  "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_id`, text, required): The person. Pick one, give their id from an earlier step, or type me for yourself.
- Group (`group_id`, text, required): The group. Pick one, or give its id from an earlier step.

**Outputs**

- `group_id` (text): The group
- `member_id` (text): The user
- `removed` (true/false): Always true once removed

**Example output**

```json
{
  "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_id`, text, required): The project. Pick one, or give its id from an earlier step.
- Name (`name`, text): A new name. Leave empty to keep it.
- Description (`description`, text): A new description. Leave empty to keep it.

**Outputs**

- `project` (object): The project

**Example output**

```json
{
  "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_id`, text, required): The task's id, from 'List tasks', 'Create task' or an earlier step.
- Name (`name`, text): A new name. Leave empty to keep it.
- Description (`description`, text): A new description. Leave empty to keep it.
- Project (`project_id`, text): Move the task to this project. Leave empty to keep it.
- Status (`status`, text): Open or closed. Leave empty to keep it. One of: `open`, `closed`.
- Visible to everyone (`public`, true/false): Let everyone in the company see the task. Leave empty to keep it.

**Outputs**

- `task` (object): The task

**Example output**

```json
{
  "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"
  }
}
```
