# Kimai

> Track time in Kimai: start and stop timers, log and edit time entries, and manage customers, projects, activities and tags.

App · 29 actions. Web page: https://docs.lodol.com/docs/integrations/kimai

## Actions

### Create activity

Create an activity for one project, or a global one that any project can use when you leave the project empty.

**Inputs**

- Name (`name`, text, required): The activity's name.
- Project (`project`, text): The project it belongs to. Leave empty for a global activity.
- Number (`number`, text): Your own reference number for it, such as a project code.
- Comment (`comment`, text): A note shown in Kimai's screens, not to your customer.
- Visible (`visible`, true/false): Turn off to create it hidden from the lists people pick from. Default: `true`.
- Billable (`billable`, true/false): Whether time recorded on it can be billed. Default: `true`.

**Outputs**

- `activity` (object): The new activity

**Example output**

```json
{
  "activity": {
    "billable": true,
    "color": null,
    "comment": null,
    "id": 11,
    "metaFields": [],
    "name": "Design",
    "number": null,
    "parentTitle": "Website relaunch",
    "project": 7,
    "teams": [],
    "visible": true
  }
}
```

### Create customer

Create a customer that projects can be added to.

**Inputs**

- Name (`name`, text, required): The customer's name.
- Number (`number`, text): Your own reference number for it, such as a project code.
- Company (`company`, text): The customer's company name for invoices.
- Contact person (`contact`, text): Who to contact at the customer.
- Email (`email`, text): The customer's email address.
- Phone (`phone`, text): The customer's phone number.
- Comment (`comment`, text): A note shown in Kimai's screens, not to your customer.
- Country (`country`, text): The two-letter country code, such as DE or US.
- Currency (`currency`, text): The three-letter currency code, such as EUR or USD.
- Visible (`visible`, true/false): Turn off to create it hidden from the lists people pick from. Default: `true`.
- Billable (`billable`, true/false): Whether time recorded on it can be billed. Default: `true`.

**Outputs**

- `customer` (object): The new customer

**Example output**

```json
{
  "customer": {
    "billable": true,
    "color": null,
    "comment": null,
    "company": "Acme Corp GmbH",
    "contact": "Jo Bloggs",
    "country": "DE",
    "currency": "EUR",
    "email": "billing@example.com",
    "homepage": null,
    "id": 3,
    "language": "en",
    "metaFields": [],
    "name": "Acme Corp",
    "number": "C-0003",
    "phone": null,
    "teams": [],
    "timezone": "Europe/Berlin",
    "visible": true
  }
}
```

### Create project

Create a project for a customer.

**Inputs**

- Name (`name`, text, required): The project's name.
- Customer (`customer`, text, required): The customer the project is for.
- Number (`number`, text): Your own reference number for it, such as a project code.
- Comment (`comment`, text): A note shown in Kimai's screens, not to your customer.
- Allow global activities (`global_activities`, true/false): Whether time on this project can use activities that belong to no project. Default: `true`.
- Visible (`visible`, true/false): Turn off to create it hidden from the lists people pick from. Default: `true`.
- Billable (`billable`, true/false): Whether time recorded on it can be billed. Default: `true`.

**Outputs**

- `project` (object): The new project

**Example output**

```json
{
  "project": {
    "billable": true,
    "color": null,
    "comment": null,
    "customer": 3,
    "end": null,
    "globalActivities": true,
    "id": 7,
    "metaFields": [],
    "name": "Website relaunch",
    "number": "P-0007",
    "orderDate": null,
    "orderNumber": null,
    "parentTitle": "Acme Corp",
    "start": null,
    "teams": [],
    "visible": true
  }
}
```

### Create tag

Create a tag. Needs the 'create tags' permission; timesheet steps also create a tag the first time they use a new name.

**Inputs**

- Name (`name`, text, required): The tag's name, without commas.

**Outputs**

- `tag` (object): The new tag

**Example output**

```json
{
  "tag": {
    "color": null,
    "id": 5,
    "name": "billable-review",
    "visible": true
  }
}
```

### Delete activity

Delete an activity for good, together with the time recorded on it.

**Inputs**

- Activity (`activity_id`, text, required): The activity. Pick one, or give its id from an earlier step.

**Outputs**

- `activity_id` (number): The activity deleted
- `deleted` (true/false): Always true once deleted

**Example output**

```json
{
  "activity_id": 11,
  "deleted": true
}
```

### Delete customer

Delete a customer for good, together with ALL its projects, activities and the time recorded on them.

**Inputs**

- Customer (`customer_id`, text, required): The customer. Pick one, or give its id from an earlier step.

**Outputs**

- `customer_id` (number): The customer deleted
- `deleted` (true/false): Always true once deleted

**Example output**

```json
{
  "customer_id": 3,
  "deleted": true
}
```

### Delete project

Delete a project for good, together with its activities and the time recorded on it.

**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` (number): The project deleted

**Example output**

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

### Delete tag

Delete a tag. Time entries that used it keep their other tags.

**Inputs**

- Tag ID (`tag_id`, number, required): The tag's id, from 'List tags' or 'Create tag'. At least 1.

**Outputs**

- `deleted` (true/false): Always true once deleted
- `tag_id` (number): The tag deleted

**Example output**

```json
{
  "deleted": true,
  "tag_id": 5
}
```

### Delete timesheet

Delete a time entry for good.

**Inputs**

- Timesheet ID (`timesheet_id`, number, required): The timesheet entry's id, from 'List timesheets', 'Start timer', 'Log time' or an earlier step. At least 1.

**Outputs**

- `deleted` (true/false): Always true once deleted
- `timesheet_id` (number): The time entry deleted

**Example output**

```json
{
  "deleted": true,
  "timesheet_id": 42
}
```

### Get activity

Get one activity.

**Inputs**

- Activity (`activity_id`, text, required): The activity. Pick one, or give its id from an earlier step.

**Outputs**

- `activity` (object): The activity

**Example output**

```json
{
  "activity": {
    "billable": true,
    "color": null,
    "comment": null,
    "id": 11,
    "metaFields": [],
    "name": "Design",
    "number": null,
    "parentTitle": "Website relaunch",
    "project": 7,
    "teams": [],
    "visible": true
  }
}
```

### Get current user

Get the Kimai user the API token acts as: name, email, language, time zone and roles.

**Inputs**: None.

**Outputs**

- `user` (object): The connected user

**Example output**

```json
{
  "user": {
    "alias": "Susan Super",
    "avatar": null,
    "email": "susan@example.com",
    "enabled": true,
    "id": 1,
    "initials": "SS",
    "language": "en",
    "locale": "en",
    "roles": [
      "ROLE_USER"
    ],
    "timezone": "Europe/Berlin",
    "title": "Team lead",
    "username": "susan"
  }
}
```

### Get customer

Get one customer.

**Inputs**

- Customer (`customer_id`, text, required): The customer. Pick one, or give its id from an earlier step.

**Outputs**

- `customer` (object): The customer

**Example output**

```json
{
  "customer": {
    "billable": true,
    "color": null,
    "comment": null,
    "company": "Acme Corp GmbH",
    "contact": "Jo Bloggs",
    "country": "DE",
    "currency": "EUR",
    "email": "billing@example.com",
    "homepage": null,
    "id": 3,
    "language": "en",
    "metaFields": [],
    "name": "Acme Corp",
    "number": "C-0003",
    "phone": null,
    "teams": [],
    "timezone": "Europe/Berlin",
    "visible": true
  }
}
```

### Get project

Get one project.

**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": {
    "billable": true,
    "color": null,
    "comment": null,
    "customer": 3,
    "end": null,
    "globalActivities": true,
    "id": 7,
    "metaFields": [],
    "name": "Website relaunch",
    "number": "P-0007",
    "orderDate": null,
    "orderNumber": null,
    "parentTitle": "Acme Corp",
    "start": null,
    "teams": [],
    "visible": true
  }
}
```

### Get running timers

Get the timers the token's user has running right now. Empty when none is running.

**Inputs**: None.

**Outputs**

- `count` (number): How many came back
- `timesheets` (list): The running timers

**Example output**

```json
{
  "count": 1,
  "timesheets": [
    {
      "activity": 11,
      "begin": "2026-10-20T09:00:00+0200",
      "billable": true,
      "description": "Wireframes",
      "duration": 0,
      "end": null,
      "exported": false,
      "fixedRate": null,
      "hourlyRate": 75,
      "id": 42,
      "internalRate": 0,
      "metaFields": [],
      "project": 7,
      "rate": 112.5,
      "tags": [
        "billable-review"
      ],
      "user": 1
    }
  ]
}
```

### Get timesheet

Get one time entry with its times, project, activity, tags and rate.

**Inputs**

- Timesheet ID (`timesheet_id`, number, required): The timesheet entry's id, from 'List timesheets', 'Start timer', 'Log time' or an earlier step. At least 1.

**Outputs**

- `timesheet` (object): The time entry

**Example output**

```json
{
  "timesheet": {
    "activity": 11,
    "begin": "2026-10-20T09:00:00+0200",
    "billable": true,
    "description": "Wireframes",
    "duration": 5400,
    "end": "2026-10-20T10:30:00+0200",
    "exported": false,
    "fixedRate": null,
    "hourlyRate": 75,
    "id": 42,
    "internalRate": 0,
    "metaFields": [],
    "project": 7,
    "rate": 112.5,
    "tags": [
      "billable-review"
    ],
    "user": 1
  }
}
```

### List activities

List activities, all at once, optionally only those of one project or only the global ones.

**Inputs**

- Project (`project`, text): Only this project's activities, and the global ones.
- Global activities only (`globals_only`, true/false): Turn on to list only activities that belong to no project. Default: `false`.
- Visibility (`visible`, text): Show visible records, hidden ones, or both. Defaults to visible only. One of: `1` (Visible only (default)), `2` (Hidden only), `3` (Visible and hidden).
- Search text (`term`, text): Only records matching this text.
- Sort by (`order_by`, text): What to sort the records by. One of: `name` (Name (default)), `project`, `id`.
- Order (`order`, text): Ascending or descending. Defaults to ascending. One of: `ASC` (Ascending (default)), `DESC` (Descending).

**Outputs**

- `activities` (list): The activities
- `count` (number): How many came back

**Example output**

```json
{
  "activities": [
    {
      "billable": true,
      "color": null,
      "comment": null,
      "id": 11,
      "metaFields": [],
      "name": "Design",
      "number": null,
      "parentTitle": "Website relaunch",
      "project": 7,
      "teams": [],
      "visible": true
    }
  ],
  "count": 1
}
```

### List customers

List customers, all at once, with their currency, country and flags.

**Inputs**

- Visibility (`visible`, text): Show visible records, hidden ones, or both. Defaults to visible only. One of: `1` (Visible only (default)), `2` (Hidden only), `3` (Visible and hidden).
- Search text (`term`, text): Only records matching this text.
- Sort by (`order_by`, text): What to sort the records by. One of: `name` (Name (default)), `id`.
- Order (`order`, text): Ascending or descending. Defaults to ascending. One of: `ASC` (Ascending (default)), `DESC` (Descending).

**Outputs**

- `count` (number): How many came back
- `customers` (list): The customers

**Example output**

```json
{
  "count": 1,
  "customers": [
    {
      "billable": true,
      "color": null,
      "comment": null,
      "company": "Acme Corp GmbH",
      "contact": "Jo Bloggs",
      "country": "DE",
      "currency": "EUR",
      "email": "billing@example.com",
      "homepage": null,
      "id": 3,
      "language": "en",
      "metaFields": [],
      "name": "Acme Corp",
      "number": "C-0003",
      "phone": null,
      "teams": [],
      "timezone": "Europe/Berlin",
      "visible": true
    }
  ]
}
```

### List projects

List projects, all at once, optionally only those of one customer.

**Inputs**

- Customer (`customer`, text): Only this customer's projects.
- Visibility (`visible`, text): Show visible records, hidden ones, or both. Defaults to visible only. One of: `1` (Visible only (default)), `2` (Hidden only), `3` (Visible and hidden).
- Search text (`term`, text): Only records matching this text.
- Sort by (`order_by`, text): What to sort the records by. One of: `name` (Name (default)), `customer`, `id`.
- Order (`order`, text): Ascending or descending. Defaults to ascending. One of: `ASC` (Ascending (default)), `DESC` (Descending).

**Outputs**

- `count` (number): How many came back
- `projects` (list): The projects

**Example output**

```json
{
  "count": 1,
  "projects": [
    {
      "billable": true,
      "color": null,
      "comment": null,
      "customer": 3,
      "end": null,
      "globalActivities": true,
      "id": 7,
      "metaFields": [],
      "name": "Website relaunch",
      "number": "P-0007",
      "orderDate": null,
      "orderNumber": null,
      "parentTitle": "Acme Corp",
      "start": null,
      "teams": [],
      "visible": true
    }
  ]
}
```

### List tags

List tags, optionally only those matching some text.

**Inputs**

- Search text (`name`, text): Only tags whose name contains this text.

**Outputs**

- `count` (number): How many came back
- `tags` (list): The tags

**Example output**

```json
{
  "count": 1,
  "tags": [
    {
      "color": null,
      "id": 5,
      "name": "billable-review",
      "visible": true
    }
  ]
}
```

### List timesheets

List time entries, newest first, filtered by project, activity, dates, tags and more. Gets one page; to see more, run it again with the next page.

**Inputs**

- User (`user`, text): Only this user's entries. Needs Kimai's 'view other timesheets' permission; defaults to the token's own user.
- Customer (`customer`, text): Only entries for this customer.
- Project (`project`, text): Only entries for this project.
- Activity (`activity`, text): Only entries for this activity.
- Tags (`tags`, list): Only entries with these tags.
- Started on or after (`begin`, date and time): Only entries that started at or after this time.
- Started on or before (`end`, date and time): Only entries that started at or before this time.
- Running (`running`, text): Only running timers, or only stopped entries. One of: `any` (Running and stopped (default)), `running` (Running only), `stopped` (Stopped only).
- Billable (`billable`, text): Only billable entries, or only those that are not. One of: `any` (Billable and not (default)), `billable` (Billable only), `non_billable` (Not billable only).
- Exported (`exported`, text): Only entries already exported or invoiced, or not yet. One of: `any` (Exported and not (default)), `exported` (Exported only), `not_exported` (Not exported only).
- Search text (`term`, text): Only records matching this text.
- Sort by (`order_by`, text): What to sort the records by. One of: `begin` (Start time (default)), `end` (End time), `rate`, `id`.
- Order (`order`, text): Newest first or oldest first. Defaults to newest first. One of: `DESC` (Newest first (default)), `ASC` (Oldest first).
- Page (`page`, number): Which page to get, starting at 1. Defaults to the first. At least 1.
- Page size (`size`, number): How many entries per page, 1 to 500. Defaults to 50. From 1 to 500.

**Outputs**

- `count` (number): How many came back on this page
- `has_more` (true/false): Whether a later page exists
- `page` (number): This page's number
- `per_page` (number): The page size Kimai used
- `timesheets` (list): The time entries on this page
- `total_count` (number): How many match in all
- `total_pages` (number): How many pages there are

**Example output**

```json
{
  "count": 1,
  "has_more": false,
  "page": 1,
  "per_page": 50,
  "timesheets": [
    {
      "activity": 11,
      "begin": "2026-10-20T09:00:00+0200",
      "billable": true,
      "description": "Wireframes",
      "duration": 5400,
      "end": "2026-10-20T10:30:00+0200",
      "exported": false,
      "fixedRate": null,
      "hourlyRate": 75,
      "id": 42,
      "internalRate": 0,
      "metaFields": [],
      "project": 7,
      "rate": 112.5,
      "tags": [
        "billable-review"
      ],
      "user": 1
    }
  ],
  "total_count": 1,
  "total_pages": 1
}
```

### List users

List Kimai users. Needs the 'view users' permission, which usually only team leads and administrators have.

**Inputs**

- Visibility (`visible`, text): Show visible records, hidden ones, or both. Defaults to visible only. One of: `1` (Visible only (default)), `2` (Hidden only), `3` (Visible and hidden).
- Search text (`term`, text): Only records matching this text.
- Sort by (`order_by`, text): What to sort the records by. One of: `username` (Username (default)), `alias` (Display name), `email`, `id`.
- Order (`order`, text): Ascending or descending. Defaults to ascending. One of: `ASC` (Ascending (default)), `DESC` (Descending).

**Outputs**

- `count` (number): How many came back
- `users` (list): The users

**Example output**

```json
{
  "count": 1,
  "users": [
    {
      "alias": "Susan Super",
      "avatar": null,
      "email": "susan@example.com",
      "enabled": true,
      "id": 1,
      "initials": "SS",
      "language": "en",
      "locale": "en",
      "roles": [
        "ROLE_USER"
      ],
      "timezone": "Europe/Berlin",
      "title": "Team lead",
      "username": "susan"
    }
  ]
}
```

### Log time

Record time already worked on a project and activity, between two moments.

**Inputs**

- Project (`project`, text, required): The project the time belongs to.
- Activity (`activity`, text, required): The activity done. It must be global or belong to the project.
- Start (`begin`, date and time, required): When the work started.
- End (`end`, date and time, required): When the work ended. It must be after the start.
- Description (`description`, text): What was worked on.
- Tags (`tags`, list): Tags for the entry. Pick existing ones or type new names.
- Billable (`billable`, text): Whether the time can be billed. Defaults to Kimai's rule. One of: `auto` (Let Kimai decide (default)), `yes` (Billable), `no` (Not billable).

**Outputs**

- `timesheet` (object): The new time entry

**Example output**

```json
{
  "timesheet": {
    "activity": 11,
    "begin": "2026-10-20T09:00:00+0200",
    "billable": true,
    "description": "Wireframes",
    "duration": 5400,
    "end": "2026-10-20T10:30:00+0200",
    "exported": false,
    "fixedRate": null,
    "hourlyRate": 75,
    "id": 42,
    "internalRate": 0,
    "metaFields": [],
    "project": 7,
    "rate": 112.5,
    "tags": [
      "billable-review"
    ],
    "user": 1
  }
}
```

### Restart timer

Start a new running timer on the same project and activity as an earlier entry, which stays as it is.

**Inputs**

- Timesheet ID (`timesheet_id`, number, required): The timesheet entry's id, from 'List timesheets', 'Start timer', 'Log time' or an earlier step. At least 1.
- Copy from the old entry (`copy`, text): What to carry over to the new timer. One of: `nothing` (Start a blank entry (default)), `all` (Copy description, tags and rates).
- Start (`begin`, date and time): When the new timer starts. Leave empty to start it now.

**Outputs**

- `timesheet` (object): The new running timer

**Example output**

```json
{
  "timesheet": {
    "activity": 11,
    "begin": "2026-10-20T09:00:00+0200",
    "billable": true,
    "description": "Wireframes",
    "duration": 0,
    "end": null,
    "exported": false,
    "fixedRate": null,
    "hourlyRate": 75,
    "id": 43,
    "internalRate": 0,
    "metaFields": [],
    "project": 7,
    "rate": 112.5,
    "tags": [
      "billable-review"
    ],
    "user": 1
  }
}
```

### Start timer

Start a running timer on a project and activity, now or at an earlier time. Kimai may refuse it while another timer is running.

**Inputs**

- Project (`project`, text, required): The project the time belongs to.
- Activity (`activity`, text, required): The activity done. It must be global or belong to the project.
- Start (`begin`, date and time): When the timer started. Leave empty to start it now.
- Description (`description`, text): What was worked on.
- Tags (`tags`, list): Tags for the entry. Pick existing ones or type new names.
- Billable (`billable`, text): Whether the time can be billed. Defaults to Kimai's rule. One of: `auto` (Let Kimai decide (default)), `yes` (Billable), `no` (Not billable).

**Outputs**

- `timesheet` (object): The running timer

**Example output**

```json
{
  "timesheet": {
    "activity": 11,
    "begin": "2026-10-20T09:00:00+0200",
    "billable": true,
    "description": "Wireframes",
    "duration": 0,
    "end": null,
    "exported": false,
    "fixedRate": null,
    "hourlyRate": 75,
    "id": 42,
    "internalRate": 0,
    "metaFields": [],
    "project": 7,
    "rate": 112.5,
    "tags": [
      "billable-review"
    ],
    "user": 1
  }
}
```

### Stop timer

Stop a running timer now.

**Inputs**

- Timesheet ID (`timesheet_id`, number, required): The timesheet entry's id, from 'List timesheets', 'Start timer', 'Log time' or an earlier step. At least 1.

**Outputs**

- `timesheet` (object): The stopped time entry

**Example output**

```json
{
  "timesheet": {
    "activity": 11,
    "begin": "2026-10-20T09:00:00+0200",
    "billable": true,
    "description": "Wireframes",
    "duration": 5400,
    "end": "2026-10-20T10:30:00+0200",
    "exported": false,
    "fixedRate": null,
    "hourlyRate": 75,
    "id": 42,
    "internalRate": 0,
    "metaFields": [],
    "project": 7,
    "rate": 112.5,
    "tags": [
      "billable-review"
    ],
    "user": 1
  }
}
```

### Update activity

Change an activity's details. Fields left empty stay as they are. Moving it to another project is not offered here.

**Inputs**

- Activity (`activity_id`, text, required): The activity. Pick one, or give its id from an earlier step.
- Name (`name`, text): A new name. Leave empty to keep it.
- Number (`number`, text): Your own reference number for it, such as a project code.
- Comment (`comment`, text): A note shown in Kimai's screens, not to your customer.
- Visible (`visible`, text): Show or hide it. Leave as is to keep the current setting. One of: `keep` (Leave as is (default)), `yes`, `no`.
- Billable (`billable`, text): Whether time on it can be billed. Leave as is to keep the setting. One of: `keep` (Leave as is (default)), `yes`, `no`.

**Outputs**

- `activity` (object): The updated activity

**Example output**

```json
{
  "activity": {
    "billable": true,
    "color": null,
    "comment": null,
    "id": 11,
    "metaFields": [],
    "name": "Design",
    "number": null,
    "parentTitle": "Website relaunch",
    "project": 7,
    "teams": [],
    "visible": true
  }
}
```

### Update customer

Change a customer's details. Fields left empty stay as they are.

**Inputs**

- Customer (`customer_id`, text, required): The customer. Pick one, or give its id from an earlier step.
- Name (`name`, text): A new name. Leave empty to keep it.
- Number (`number`, text): Your own reference number for it, such as a project code.
- Company (`company`, text): The customer's company name for invoices.
- Contact person (`contact`, text): Who to contact at the customer.
- Email (`email`, text): The customer's email address.
- Phone (`phone`, text): The customer's phone number.
- Comment (`comment`, text): A note shown in Kimai's screens, not to your customer.
- Country (`country`, text): The two-letter country code, such as DE or US.
- Currency (`currency`, text): The three-letter currency code, such as EUR or USD.
- Visible (`visible`, text): Show or hide it. Leave as is to keep the current setting. One of: `keep` (Leave as is (default)), `yes`, `no`.
- Billable (`billable`, text): Whether time on it can be billed. Leave as is to keep the setting. One of: `keep` (Leave as is (default)), `yes`, `no`.

**Outputs**

- `customer` (object): The updated customer

**Example output**

```json
{
  "customer": {
    "billable": true,
    "color": null,
    "comment": null,
    "company": "Acme Corp GmbH",
    "contact": "Jo Bloggs",
    "country": "DE",
    "currency": "EUR",
    "email": "billing@example.com",
    "homepage": null,
    "id": 3,
    "language": "en",
    "metaFields": [],
    "name": "Acme Corp",
    "number": "C-0003",
    "phone": null,
    "teams": [],
    "timezone": "Europe/Berlin",
    "visible": true
  }
}
```

### Update project

Change a project's details. Fields left empty stay as they are. Moving it to another customer is not offered here.

**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.
- Number (`number`, text): Your own reference number for it, such as a project code.
- Comment (`comment`, text): A note shown in Kimai's screens, not to your customer.
- Allow global activities (`global_activities`, text): Whether time can use activities that belong to no project. One of: `keep` (Leave as is (default)), `yes`, `no`.
- Visible (`visible`, text): Show or hide it. Leave as is to keep the current setting. One of: `keep` (Leave as is (default)), `yes`, `no`.
- Billable (`billable`, text): Whether time on it can be billed. Leave as is to keep the setting. One of: `keep` (Leave as is (default)), `yes`, `no`.

**Outputs**

- `project` (object): The updated project

**Example output**

```json
{
  "project": {
    "billable": true,
    "color": null,
    "comment": null,
    "customer": 3,
    "end": null,
    "globalActivities": true,
    "id": 7,
    "metaFields": [],
    "name": "Website relaunch",
    "number": "P-0007",
    "orderDate": null,
    "orderNumber": null,
    "parentTitle": "Acme Corp",
    "start": null,
    "teams": [],
    "visible": true
  }
}
```

### Update timesheet

Change a time entry's project, activity, times, description, tags or billable setting. Fields left empty stay as they are.

**Inputs**

- Timesheet ID (`timesheet_id`, number, required): The timesheet entry's id, from 'List timesheets', 'Start timer', 'Log time' or an earlier step. At least 1.
- Project (`project`, text): Move the entry to this project. Leave empty to keep it.
- Activity (`activity`, text): Change the activity. Leave empty to keep it.
- Start (`begin`, date and time): A new start time. Leave empty to keep it.
- End (`end`, date and time): A new end time. Leave empty to keep it.
- Description (`description`, text): A new description. Leave empty to keep it.
- Tags (`tags`, list): Replace the entry's tags with these. Leave empty to keep them.
- Billable (`billable`, text): Whether the time can be billed. Leave as is to keep it. One of: `keep` (Leave as is (default)), `yes` (Billable), `no` (Not billable).

**Outputs**

- `timesheet` (object): The updated time entry

**Example output**

```json
{
  "timesheet": {
    "activity": 11,
    "begin": "2026-10-20T09:00:00+0200",
    "billable": true,
    "description": "Wireframes",
    "duration": 5400,
    "end": "2026-10-20T10:30:00+0200",
    "exported": false,
    "fixedRate": null,
    "hourlyRate": 75,
    "id": 42,
    "internalRate": 0,
    "metaFields": [],
    "project": 7,
    "rate": 112.5,
    "tags": [
      "billable-review"
    ],
    "user": 1
  }
}
```
