API 2.0

Time Reports

New Time Report

Submit a new time report.
/task/TASK-ID/time-report

Parameters

Name Required Type/Format Description
userId yes String User on behalf of whom API will report time
date no YYYY-MM-DD Date you want to report time for, current date will be set if not passed
reportedMinutes yes Integer Reported time in minutes
message no String Comment

Query time reports by user

Retrieve list of user's time reports for a specified period of time
/user/USER-ID/time-reports

Parameters

Name Required Type/Format Description
startDate no YYYY-MM-DD Start date filter
endDate no YYYY-MM-DD End date filter

Response

Sample response →
[
    {
        "momentCreated": "2016-06-09T12:00:00",
        "project": {
            "id": "PROJECT-ID",
            "name": "UI Design"
        },
        "reportDate": "2018-06-09",
        "task": {
            "id": "TASK-ID",
            "name": "test task"
        },
        "taskMessage": null,
        "timeReported": 180
    },
]

Query time reports by task

List of time reports for a specific task
/task/TASK-ID/time-reports

Parameters

Name Required Default Type/Format Description
subtasks no False Boolean set to true to include time reports for all subtasks
startDate no YYYY-MM-DD Start date filter
endDate no YYYY-MM-DD End date filter

Response

Sample response →
[
    {
        "momentCreated": "2018-06-09T12:00:00",
        "project": {
            "id": "PROJECT-ID",
            "name": "UI Design"
        },
        "reportDate": "2018-06-09",
        "task": {
            "id": "TASK-ID",
            "name": "test task"
        },
        "taskMessage": null,
        "timeReported": 180
    },
    ...
]

Query time reports by project

List of time reports for a specific folder/project
/project/PROJECT-ID/time-reports

Parameters

Name Required Default Type/Format Description
subfolders no False Boolean set to true to include time reports for all subprojects
startDate no YYYY-MM-DD Start date filter
endDate no YYYY-MM-DD End date filter

Response

Sample response →
[
    {
        "momentCreated": "2018-06-22T12:00:00",
        "reportDate": "2018-06-22",
        "taskId": "TASK-ID",
        "taskMessage": null,
        "timeReported": 20,
        "userId": "USER-ID"
    },
    ...
]

Query all time reports

Retrieve list of all time reports for a specified period of time
/time-reports

Parameters

Name Required Type/Format Description
startDate yes YYYY-MM-DD Start date filter
endDate yes YYYY-MM-DD End date filter
projectIds no array of ids i.e. ['ID1', 'ID2'] Projects filter
userIds no array of ids i.e. ['ID1', 'ID2'] Users filter

Response

Sample response →
[
    {
        "id": "TIME-REPORT-ID",
        "message": "time report comment / message",
        "momentCreated": "2020-01-01T12:56:24.427922",
        "projectId": "PROJECT-ID",
        "reportDate": "2020-01-02",
        "reported": 120,
        "taskId": "TASK-ID",
        "userId": "USER-ID"
    },
]