Time entries

Documents the REST API to retrieve time entry items.

Deprecated

This version of the API is no longer supported and won't receive any updates towards the future. This documentation is here for troubleshooting purposes. Our v1.0 version will be taken offline on Oct 1, 2024. You have until this date to move to our v2.0 version.

Get a list of worklogs starting from startDate

GEThttps://tracket.dev/api/1.0/worklogs

Authorization

apiAuth

Query parameters

Response

200

Body

*/*

next-cursorstring

worklogs*array of object

Request

JavaScriptCurlPython

const response = await fetch('https://tracket.dev/api/1.0/worklogs', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200

{
  "next-cursor": "text",
  "worklogs": [
    {
      "itemId": "text",
      "userId": "text",
      "description": "text",
      "worklogCategory": "text",
      "worklogDate": "2024-10-22T18:45:31.370Z",
      "worklogMinutes": 0,
      "worklogBillableMinutes": 0,
      "worklogId": "text",
      "createdDate": "2024-10-22T18:45:31.370Z",
      "updatedDate": "2024-10-22T18:45:31.370Z",
      "approvalStatus": "open",
      "approverUserId": "text"
    }
  ]
}

Get a worklog by id

GEThttps://tracket.dev/api/1.0/worklogs/{id}

Authorization

apiAuth

Path parameters

id*string

Response

200403404

Body

*/*

itemId*nullable string

The item id

userId*string

The user id

descriptionnullable string

Description of the worklog

worklogCategorynullable string

Id of the category of this worklog

worklogDate*string (date-time)

Date of the worklog

worklogMinutes*number (double)

Number of minutes worked

worklogBillableMinutesnullable number (double)

Number of billable minutes

worklogId*string

The worklog id

createdDatestring (date-time)

The date when worklog was created, this was introduced later so this can miss on older worklogs

updatedDatenullable string (date-time)

The date when worklog was last updated

approvalStatusenum

The approval status open/approved/submitted/rejected

openapprovedsubmittedrejected

approverUserIdnullable string

The user id of the approver

Request

JavaScriptCurlPython

const response = await fetch('https://tracket.dev/api/1.0/worklogs/{id}', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200403404

{
  "itemId": "text",
  "userId": "text",
  "description": "text",
  "worklogCategory": "text",
  "worklogDate": "2024-10-22T18:45:31.370Z",
  "worklogMinutes": 0,
  "worklogBillableMinutes": 0,
  "worklogId": "text",
  "createdDate": "2024-10-22T18:45:31.370Z",
  "updatedDate": "2024-10-22T18:45:31.370Z",
  "approvalStatus": "open",
  "approverUserId": "text"
}

Create a new worklog.

POSThttps://tracket.dev/api/1.0/worklogs

Authorization

apiAuth

Body

application/json

itemId*string

The item id

userId*string

The user id

descriptionnullable string

Description of the worklog

worklogCategorynullable string

Id of the category of this worklog

worklogDate*string (date-time)

Date of the worklog

worklogMinutes*number (double)

Number of minutes worked

worklogBillableMinutesnullable number (double)

Number of billable minutes

Response

201400

Body

*/*

itemId*string

The item id

userId*string

The user id

descriptionnullable string

Description of the worklog

worklogCategorynullable string

Id of the category of this worklog

worklogDate*string (date-time)

Date of the worklog

worklogMinutes*number (double)

Number of minutes worked

worklogBillableMinutesnullable number (double)

Number of billable minutes

worklogId*string

The worklog id

createdDatestring (date-time)

The date when worklog was created, this was introduced later so this can miss on older worklogs

updatedDatenullable string (date-time)

The date when worklog was last updated

approvalStatusenum

The approval status open/approved/submitted/rejected

openapprovedsubmittedrejected

approverUserIdnullable string

The user id of the approver

Request

JavaScriptCurlPython

const response = await fetch('https://tracket.dev/api/1.0/worklogs', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "itemId": "text",
      "userId": "text",
      "worklogDate": "2024-10-22T18:45:31.370Z",
      "worklogMinutes": 0
    }),
});
const data = await response.json();

Response

201400

{
  "itemId": "text",
  "userId": "text",
  "description": "text",
  "worklogCategory": "text",
  "worklogDate": "2024-10-22T18:45:31.370Z",
  "worklogMinutes": 0,
  "worklogBillableMinutes": 0,
  "worklogId": "text",
  "createdDate": "2024-10-22T18:45:31.370Z",
  "updatedDate": "2024-10-22T18:45:31.370Z",
  "approvalStatus": "open",
  "approverUserId": "text"
}

Update worklog

PUThttps://tracket.dev/api/1.0/worklogs/{id}

Authorization

apiAuth

Path parameters

id*string

Body

application/json

itemIdstring

The item id

userIdstring

The user id

descriptionnullable string

Description of the worklog

worklogCategorynullable string

Id of the category of this worklog

worklogDatestring (date-time)

Date of the worklog

worklogMinutesnumber (double)

Number of minutes worked

worklogBillableMinutesnullable number (double)

Number of billable minutes

Response

200400403404

Body

*/*

itemId*string

The item id

userId*string

The user id

descriptionnullable string

Description of the worklog

worklogCategorynullable string

Id of the category of this worklog

worklogDate*string (date-time)

Date of the worklog

worklogMinutes*number (double)

Number of minutes worked

worklogBillableMinutesnullable number (double)

Number of billable minutes

worklogId*string

The worklog id

createdDatestring (date-time)

The date when worklog was created, this was introduced later so this can miss on older worklogs

updatedDatenullable string (date-time)

The date when worklog was last updated

approverUserIdnullable string

The user id of the approver

Request

JavaScriptCurlPython

const response = await fetch('https://tracket.dev/api/1.0/worklogs/{id}', {
    method: 'PUT',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({}),
});
const data = await response.json();

Response

200400403404

{
  "itemId": "text",
  "userId": "text",
  "description": "text",
  "worklogCategory": "text",
  "worklogDate": "2024-10-22T18:45:31.370Z",
  "worklogMinutes": 0,
  "worklogBillableMinutes": 0,
  "worklogId": "text",
  "createdDate": "2024-10-22T18:45:31.370Z",
  "updatedDate": "2024-10-22T18:45:31.370Z",
  "approverUserId": "text"
}

Delete worklog

DELETEhttps://tracket.dev/api/1.0/worklogs/{id}

Authorization

apiAuth

Path parameters

id*string

Response

200400403404

Body

*/*

message*string

Request

JavaScriptCurlPython

const response = await fetch('https://tracket.dev/api/1.0/worklogs/{id}', {
    method: 'DELETE',
    headers: {},
});
const data = await response.json();

Response

200400403404

{
  "message": "text"
}