Kimai

App · 29 actions

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

Actions

ActionWhat it does
Create activityCreate an activity for one project, or a global one that any project can use when you leave the project empty.
Create customerCreate a customer that projects can be added to.
Create projectCreate a project for a customer.
Create tagCreate a tag.
Delete activityDelete an activity for good, together with the time recorded on it.
Delete customerDelete a customer for good, together with ALL its projects, activities and the time recorded on them.
Delete projectDelete a project for good, together with its activities and the time recorded on it.
Delete tagDelete a tag.
Delete timesheetDelete a time entry for good.
Get activityGet one activity.
Get current userGet the Kimai user the API token acts as: name, email, language, time zone and roles.
Get customerGet one customer.
Get projectGet one project.
Get running timersGet the timers the token's user has running right now.
Get timesheetGet one time entry with its times, project, activity, tags and rate.
List activitiesList activities, all at once, optionally only those of one project or only the global ones.
List customersList customers, all at once, with their currency, country and flags.
List projectsList projects, all at once, optionally only those of one customer.
List tagsList tags, optionally only those matching some text.
List timesheetsList time entries, newest first, filtered by project, activity, dates, tags and more.
List usersList Kimai users.
Log timeRecord time already worked on a project and activity, between two moments.
Restart timerStart a new running timer on the same project and activity as an earlier entry, which stays as it is.
Start timerStart a running timer on a project and activity, now or at an earlier time.
Stop timerStop a running timer now.
Update activityChange an activity's details.
Update customerChange a customer's details.
Update projectChange a project's details.
Update timesheetChange a time entry's project, activity, times, description, tags or billable setting.

Create activity

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

Inputs

NamenametextRequired
The activity's name.
Projectprojecttext
The project it belongs to. Leave empty for a global activity.
Numbernumbertext
Your own reference number for it, such as a project code.
Commentcommenttext
A note shown in Kimai's screens, not to your customer.
Visiblevisibletrue/false
Turn off to create it hidden from the lists people pick from.Default: true.
Billablebillabletrue/false
Whether time recorded on it can be billed.Default: true.

Outputs

activityobject
The new activity
Example output
{
  "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

NamenametextRequired
The customer's name.
Numbernumbertext
Your own reference number for it, such as a project code.
Companycompanytext
The customer's company name for invoices.
Contact personcontacttext
Who to contact at the customer.
Emailemailtext
The customer's email address.
Phonephonetext
The customer's phone number.
Commentcommenttext
A note shown in Kimai's screens, not to your customer.
Countrycountrytext
The two-letter country code, such as DE or US.
Currencycurrencytext
The three-letter currency code, such as EUR or USD.
Visiblevisibletrue/false
Turn off to create it hidden from the lists people pick from.Default: true.
Billablebillabletrue/false
Whether time recorded on it can be billed.Default: true.

Outputs

customerobject
The new customer
Example output
{
  "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

NamenametextRequired
The project's name.
CustomercustomertextRequired
The customer the project is for.
Numbernumbertext
Your own reference number for it, such as a project code.
Commentcommenttext
A note shown in Kimai's screens, not to your customer.
Allow global activitiesglobal_activitiestrue/false
Whether time on this project can use activities that belong to no project.Default: true.
Visiblevisibletrue/false
Turn off to create it hidden from the lists people pick from.Default: true.
Billablebillabletrue/false
Whether time recorded on it can be billed.Default: true.

Outputs

projectobject
The new project
Example output
{
  "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

NamenametextRequired
The tag's name, without commas.

Outputs

tagobject
The new tag
Example output
{
  "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

Activityactivity_idtextRequired
The activity. Pick one, or give its id from an earlier step.

Outputs

activity_idnumber
The activity deleted
deletedtrue/false
Always true once deleted
Example output
{
  "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

Customercustomer_idtextRequired
The customer. Pick one, or give its id from an earlier step.

Outputs

customer_idnumber
The customer deleted
deletedtrue/false
Always true once deleted
Example output
{
  "customer_id": 3,
  "deleted": true
}

Delete project

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

Inputs

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

Outputs

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

Delete tag

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

Inputs

Tag IDtag_idnumberRequired
The tag's id, from 'List tags' or 'Create tag'.At least 1.

Outputs

deletedtrue/false
Always true once deleted
tag_idnumber
The tag deleted
Example output
{
  "deleted": true,
  "tag_id": 5
}

Delete timesheet

Delete a time entry for good.

Inputs

Timesheet IDtimesheet_idnumberRequired
The timesheet entry's id, from 'List timesheets', 'Start timer', 'Log time' or an earlier step.At least 1.

Outputs

deletedtrue/false
Always true once deleted
timesheet_idnumber
The time entry deleted
Example output
{
  "deleted": true,
  "timesheet_id": 42
}

Get activity

Get one activity.

Inputs

Activityactivity_idtextRequired
The activity. Pick one, or give its id from an earlier step.

Outputs

activityobject
The activity
Example output
{
  "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

userobject
The connected user
Example output
{
  "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

Customercustomer_idtextRequired
The customer. Pick one, or give its id from an earlier step.

Outputs

customerobject
The customer
Example output
{
  "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

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

Outputs

projectobject
The project
Example output
{
  "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

countnumber
How many came back
timesheetslist
The running timers
Example output
{
  "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 IDtimesheet_idnumberRequired
The timesheet entry's id, from 'List timesheets', 'Start timer', 'Log time' or an earlier step.At least 1.

Outputs

timesheetobject
The time entry
Example output
{
  "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

Projectprojecttext
Only this project's activities, and the global ones.
Global activities onlyglobals_onlytrue/false
Turn on to list only activities that belong to no project.Default: false.
Visibilityvisibletext
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 texttermtext
Only records matching this text.
Sort byorder_bytext
What to sort the records by.One of: name (Name (default)), project, id.
Orderordertext
Ascending or descending. Defaults to ascending.One of: ASC (Ascending (default)), DESC (Descending).

Outputs

activitieslist
The activities
countnumber
How many came back
Example output
{
  "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

Visibilityvisibletext
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 texttermtext
Only records matching this text.
Sort byorder_bytext
What to sort the records by.One of: name (Name (default)), id.
Orderordertext
Ascending or descending. Defaults to ascending.One of: ASC (Ascending (default)), DESC (Descending).

Outputs

countnumber
How many came back
customerslist
The customers
Example output
{
  "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

Customercustomertext
Only this customer's projects.
Visibilityvisibletext
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 texttermtext
Only records matching this text.
Sort byorder_bytext
What to sort the records by.One of: name (Name (default)), customer, id.
Orderordertext
Ascending or descending. Defaults to ascending.One of: ASC (Ascending (default)), DESC (Descending).

Outputs

countnumber
How many came back
projectslist
The projects
Example output
{
  "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 textnametext
Only tags whose name contains this text.

Outputs

countnumber
How many came back
tagslist
The tags
Example output
{
  "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

Userusertext
Only this user's entries. Needs Kimai's 'view other timesheets' permission; defaults to the token's own user.
Customercustomertext
Only entries for this customer.
Projectprojecttext
Only entries for this project.
Activityactivitytext
Only entries for this activity.
Tagstagslist
Only entries with these tags.
Started on or afterbegindate and time
Only entries that started at or after this time.
Started on or beforeenddate and time
Only entries that started at or before this time.
Runningrunningtext
Only running timers, or only stopped entries.One of: any (Running and stopped (default)), running (Running only), stopped (Stopped only).
Billablebillabletext
Only billable entries, or only those that are not.One of: any (Billable and not (default)), billable (Billable only), non_billable (Not billable only).
Exportedexportedtext
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 texttermtext
Only records matching this text.
Sort byorder_bytext
What to sort the records by.One of: begin (Start time (default)), end (End time), rate, id.
Orderordertext
Newest first or oldest first. Defaults to newest first.One of: DESC (Newest first (default)), ASC (Oldest first).
Pagepagenumber
Which page to get, starting at 1. Defaults to the first.At least 1.
Page sizesizenumber
How many entries per page, 1 to 500. Defaults to 50.From 1 to 500.

Outputs

countnumber
How many came back on this page
has_moretrue/false
Whether a later page exists
pagenumber
This page's number
per_pagenumber
The page size Kimai used
timesheetslist
The time entries on this page
total_countnumber
How many match in all
total_pagesnumber
How many pages there are
Example output
{
  "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

Visibilityvisibletext
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 texttermtext
Only records matching this text.
Sort byorder_bytext
What to sort the records by.One of: username (Username (default)), alias (Display name), email, id.
Orderordertext
Ascending or descending. Defaults to ascending.One of: ASC (Ascending (default)), DESC (Descending).

Outputs

countnumber
How many came back
userslist
The users
Example output
{
  "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

ProjectprojecttextRequired
The project the time belongs to.
ActivityactivitytextRequired
The activity done. It must be global or belong to the project.
Startbegindate and timeRequired
When the work started.
Endenddate and timeRequired
When the work ended. It must be after the start.
Descriptiondescriptiontext
What was worked on.
Tagstagslist
Tags for the entry. Pick existing ones or type new names.
Billablebillabletext
Whether the time can be billed. Defaults to Kimai's rule.One of: auto (Let Kimai decide (default)), yes (Billable), no (Not billable).

Outputs

timesheetobject
The new time entry
Example output
{
  "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 IDtimesheet_idnumberRequired
The timesheet entry's id, from 'List timesheets', 'Start timer', 'Log time' or an earlier step.At least 1.
Copy from the old entrycopytext
What to carry over to the new timer.One of: nothing (Start a blank entry (default)), all (Copy description, tags and rates).
Startbegindate and time
When the new timer starts. Leave empty to start it now.

Outputs

timesheetobject
The new running timer
Example output
{
  "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

ProjectprojecttextRequired
The project the time belongs to.
ActivityactivitytextRequired
The activity done. It must be global or belong to the project.
Startbegindate and time
When the timer started. Leave empty to start it now.
Descriptiondescriptiontext
What was worked on.
Tagstagslist
Tags for the entry. Pick existing ones or type new names.
Billablebillabletext
Whether the time can be billed. Defaults to Kimai's rule.One of: auto (Let Kimai decide (default)), yes (Billable), no (Not billable).

Outputs

timesheetobject
The running timer
Example output
{
  "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 IDtimesheet_idnumberRequired
The timesheet entry's id, from 'List timesheets', 'Start timer', 'Log time' or an earlier step.At least 1.

Outputs

timesheetobject
The stopped time entry
Example output
{
  "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

Activityactivity_idtextRequired
The activity. Pick one, or give its id from an earlier step.
Namenametext
A new name. Leave empty to keep it.
Numbernumbertext
Your own reference number for it, such as a project code.
Commentcommenttext
A note shown in Kimai's screens, not to your customer.
Visiblevisibletext
Show or hide it. Leave as is to keep the current setting.One of: keep (Leave as is (default)), yes, no.
Billablebillabletext
Whether time on it can be billed. Leave as is to keep the setting.One of: keep (Leave as is (default)), yes, no.

Outputs

activityobject
The updated activity
Example output
{
  "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

Customercustomer_idtextRequired
The customer. Pick one, or give its id from an earlier step.
Namenametext
A new name. Leave empty to keep it.
Numbernumbertext
Your own reference number for it, such as a project code.
Companycompanytext
The customer's company name for invoices.
Contact personcontacttext
Who to contact at the customer.
Emailemailtext
The customer's email address.
Phonephonetext
The customer's phone number.
Commentcommenttext
A note shown in Kimai's screens, not to your customer.
Countrycountrytext
The two-letter country code, such as DE or US.
Currencycurrencytext
The three-letter currency code, such as EUR or USD.
Visiblevisibletext
Show or hide it. Leave as is to keep the current setting.One of: keep (Leave as is (default)), yes, no.
Billablebillabletext
Whether time on it can be billed. Leave as is to keep the setting.One of: keep (Leave as is (default)), yes, no.

Outputs

customerobject
The updated customer
Example output
{
  "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

Projectproject_idtextRequired
The project. Pick one, or give its id from an earlier step.
Namenametext
A new name. Leave empty to keep it.
Numbernumbertext
Your own reference number for it, such as a project code.
Commentcommenttext
A note shown in Kimai's screens, not to your customer.
Allow global activitiesglobal_activitiestext
Whether time can use activities that belong to no project.One of: keep (Leave as is (default)), yes, no.
Visiblevisibletext
Show or hide it. Leave as is to keep the current setting.One of: keep (Leave as is (default)), yes, no.
Billablebillabletext
Whether time on it can be billed. Leave as is to keep the setting.One of: keep (Leave as is (default)), yes, no.

Outputs

projectobject
The updated project
Example output
{
  "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 IDtimesheet_idnumberRequired
The timesheet entry's id, from 'List timesheets', 'Start timer', 'Log time' or an earlier step.At least 1.
Projectprojecttext
Move the entry to this project. Leave empty to keep it.
Activityactivitytext
Change the activity. Leave empty to keep it.
Startbegindate and time
A new start time. Leave empty to keep it.
Endenddate and time
A new end time. Leave empty to keep it.
Descriptiondescriptiontext
A new description. Leave empty to keep it.
Tagstagslist
Replace the entry's tags with these. Leave empty to keep them.
Billablebillabletext
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

timesheetobject
The updated time entry
Example output
{
  "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
  }
}

On this page