Timesheets

Timesheets API

Scope: ZohoProjects.timesheets.{Operation}

Operations: READ, CREATE, UPDATE, DELETE, ALL

Use the ALL operation to gain the scope for all the other operations like READ, CREATE, UPDATE, and DELETE at once.

Get All Time Logs
GET  /portal/[PORTALID]/projects/[PROJECTID]/logs/
 
Get My Time Logs
GET  /portal/[PORTALID]/logs
 
Get Time Logs for a Task
GET  /portal/[PORTALID]/projects/[PROJECTID]/tasks/[TASKID]/logs/
 
Add Time Log for a Task
POST  /portal/[PORTALID]/projects/[PROJECTID]/tasks/[TASKID]/logs/
 
Update Time Log for a Task
POST /portal/[PORTALID]/projects/[PROJECTID]/tasks/[TASKID]/logs/[LOGID]/
Approve Time Log for a Task
POST /portal/[PORTALID]/projects/[PROJECTID]/tasks/[TASKID]/logs/[LOGID]/approval
Delete Time Log for a Task
DELETE  /portal/[PORTALID]/projects/[PROJECTID]/tasks/[TASKID]/logs/[LOGID]/
Get Time Logs for a Bug
GET  /portal/[PORTALID]/projects/[PROJECTID]/bugs/[ISSUE_ID]/logs/
 
Add Time Log for a Bug
POST  /portal/[PORTALID]/projects/[PROJECTID]/bugs/[BUGID]/logs/
Update Time Log for a Bug
POST  /portal/[PORTALID]/projects/[PROJECTID]/bugs/[BUGID]/logs/[LOGID]/
Approve Time Log for a Bug
POST  /portal/[PORTALID]/projects/[PROJECTID]/bugs/[BUGID]/logs/[LOGID]/approval
Delete Time Log for a Bug
DELETE  /portal/[PORTALID]/projects/[PROJECTID]/bugs/[BUGID]/logs/[LOGID]/
Add Time for a General Log
POST  /portal/[PORTALID]/projects/[PROJECTID]/logs/
Update Time for a General Log
POST  /portal/[PORTALID]/projects/[PROJECTID]/logs/[LOGID]/
Approve Time for a General Log
POST  /portal/[PORTALID]/projects/[PROJECTID]/logs/[LOGID]/approval
Delete Time for a General Log
DELETE  /portal/[PORTALID]/projects/[PROJECTID]/logs/[LOGID]/

 Get All Time Logs

Gets all the time logs in the given project.

GET  /portal/[PORTALID]/projects/[PROJECTID]/logs/

Scope: ZohoProjects.timesheets.READ

Request Parameters

indexintIndex of the time log.
rangeintRange of the time logs.
users_list*String or LongUser of the time logs must be provided as all or user ID. For multiple users, the user ID must be separated by commas.(all - String, user ID - Long)
view_type*StringView type of the timesheet must be provided as day or week or month.
date*

String

[MM-DD-YYYY]

Date of the timesheet view type.
bill_status*StringTimesheet billable status must be provided as All or Billable or Non Billable.
component_type*StringType of the component must be provided as task or bug or general.
approval_statusStringAccepted values
  • approved
  • pending
  • rejected
  • all

Sample Response

Status: 200 Success

Content Type: application/json;charset=utf-8
{
    "timelogs": {
        "date": [
            {
                "date": "12-30-2019",
                "display_format": "12-30-2019 12:00:00 AM",
                "date_long": 1577692800000,
                "total_hours": "4:00",
                "tasklogs": [
                    {
                        "created_time_long": 1577683614256,
                        "hours": 4,
                        "notes": "",
                        "owner_name": "hey ranjith",
                        "cost": "₹ 20.000",
                        "created_time_format": "12-29-2019 09:26:54 PM",
                        "minutes": 0,
                        "total_minutes": 240,
                        "owner_id": "60104829",
                        "approval_status": "Approved",
                        "custom_fields": [
                            {
                                "column_name": "UDF_BOOLEAN1",
                                "label_name": "check box",
                                "value": "true"
                            }
                        ],
                        "link": {
                            "self": {
                                "url": "https://projects.zoho.com/restapi/portal/60105112/projects/62308000000045027/tasks/62308000000046015/logs/62308000000046023/"
                            }
                        },
                        "last_modified_date": "12-29-2019",
                        "bill_status": "Billable",
                        "last_modified_time_long": 1577683614256,
                        "last_modified_time_format": "12-29-2019 09:26:54 PM",
                        "task": {
                            "sub_task_level": "0",
                            "is_sub_task": false,
                            "name": "Complete all the changes that are assigned to you on time and make them checkin to collab.",
                            "id_string": "62308000000046015",
                            "id": 62308000000046020,
                            "is_parent": true
                        },
                        "id_string": "62308000000046023",
                        "invoice_id": 56928000000097064,   //for portals integrated with Zoho Invoice
                        "created_date": "12-29-2019",
                        "id": 62308000000046024,
                        "hours_display": "04:00"
                    }
                ]
            }
        ],
        "role": "admin",
        "non_billable_hours": "00:00",
        "billable_hours": "04:00",
        "grandtotal": "04:00"
    }
}

 Get My Time Logs

Gets the time logs of all users or specific users.

GET  /portal/[PORTALID]/logs

Scope: ZohoProjects.timesheets.READ

Request Parameters

indexintIndex of the time log.
rangeintRange of the time logs.
users_list*String or LongUser of the time logs must be provided as all or user ID. For multiple users, the user ID must be separated by commas.(all - String, user ID - Long)
view_type*StringView type of the timesheet must be provided as day or week or month.
date*

String

[MM-DD-YYYY]

Date of the timesheet view type.
bill_status*StringTimesheet billable status must be provided as All or Billable or Non Billable.
component_type*StringType of the component must be provided as task or bug or general. 
approval_statusStringAccepted values
  • approved
  • pending
  • rejected
  • all

Sample Response

Status: 200 Success

Content Type: application/json;charset=utf-8
{
    "timelogs": {
        "date": [
            {
                "date": "12-30-2019",
                "display_format": "12-30-2019 12:00:00 AM",
                "date_long": 1577692800000,
                "total_hours": "4:00",
                "tasklogs": [
                    {
                        "created_time_long": 1577683614256,
                        "hours": 4,
                        "notes": "",
                        "owner_name": "hey ranjith",
                        "cost": "₹ 20.000",
                        "created_time_format": "12-29-2019 09:26:54 PM",
                        "minutes": 0,
                        "total_minutes": 240,
                        "owner_id": "60104829",
                        "approval_status": "Approved",
                        "custom_fields": [],
                        "link": {
                            "self": {
                                "url": "https://projects.zoho.com/restapi/portal/60105112/projects/62308000000045027/tasks/62308000000046015/logs/62308000000046023/"
                            }
                        },
                        "last_modified_date": "12-29-2019",
                        "project": {
                            "name": "sprints",
                            "id_string": "62308000000045027",
                            "id": 62308000000045020
                        },
                        "bill_status": "Billable",
                        "last_modified_time_long": 1577683614256,
                        "last_modified_time_format": "12-29-2019 09:26:54 PM",
                        "task": {
                            "sub_task_level": "0",
                            "is_sub_task": false,
                            "name": "Complete all the changes that are assigned to you on time and make them checkin to collab.",
                            "id_string": "62308000000046015",
                            "id": 62308000000046020,
                            "is_parent": true
                        },
                        "id_string": "62308000000046023",
                        "invoice_id": 56928000000097064,   //for portals integrated with Zoho Invoice
                        "created_date": "12-29-2019",
                        "id": 62308000000046024,
                        "hours_display": "04:00"
                    }
                ]
            }
        ],
        "role": "admin",
        "non_billable_hours": "00:00",
        "billable_hours": "04:00",
        "grandtotal": "04:00"
    }
}

 Get Time Logs for a Task

Gets the time logs under a specific task.

GET  /portal/[PORTALID]/projects/[PROJECTID]/tasks/[TASKID]/logs/

Scope: ZohoProjects.timesheets.READ

Sample Response

Status: 200 Success

Content Type: application/json;charset=utf-8
{
    "timelogs": {
        "total_log_hours": "10:00",
        "tasklogs": [
            {
                "notes": "",
                "owner_id": "60104829",
                "link": {
                    "self": {
                        "url": "https://projects.zoho.com/restapi/portal/60105112/projects/62308000000045027/tasks/62308000000046015/logs/62308000000701001/"
                    }
                },
                "last_modified_date": "09-24-2020",
                "log_date_long": 1601058599000,
                "is_parent": true,
                "sub_task_level": "0",
                "last_modified_time_long": 1601012787144,
                "invoice_id": 56928000000277000,
                "id": 62308000000701000,
                "log_date_format": "09-25-2020 11:29:59 AM",
                "created_time_long": 1601012717033,
                "hours": 2,
                "cost": "₹ 10.0",
                "owner_name": "hey ranjith",
                "created_time_format": "09-24-2020 10:45:17 PM",
                "is_sub_task": false,
                "minutes": 0,
                "total_minutes": 120,
                "approver_name": "hey ranjith",
                "approval_status": "Approved",
                "custom_fields": [
                    {
                        "column_name": "UDF_LONG1",
                        "label_name": "Number",
                        "value": "123"
                    },
                    {
                        "column_name": "UDF_CHAR10",
                        "label_name": "url 2",
                        "value": "hey.com"
                    },
                    {
                        "column_name": "UDF_CHAR12",
                        "label_name": "single one",
                        "value": "Hello"
                    },
                    {
                        "column_name": "UDF_LONG2",
                        "label_name": "F1",
                        "value": "369"
                    },
                    {
                        "column_name": "UDF_TEXT1",
                        "label_name": "multi l;ine",
                        "value": "nhuk,"
                    },
                    {
                        "column_name": "UDF_TEXT3",
                        "label_name": "F5",
                        "value": "nhuk,"
                    },
                    {
                        "column_name": "UDF_DATE4",
                        "label_name": "F3",
                        "value": "09-21-2020 11:30:00 AM"
                    },
                    {
                        "column_name": "UDF_DATE2",
                        "label_name": "date only",
                        "value": "09-14-2020 11:30:00 AM"
                    },
                    {
                        "column_name": "UDF_DATE3",
                        "label_name": "date and time",
                        "value": "09-21-2020 11:30:00 AM"
                    },
                    {
                        "column_name": "UDF_DATE1",
                        "label_name": "F2",
                        "value": "09-14-2020 11:30:00 AM"
                    },
                    {
                        "column_name": "UDF_CHAR7",
                        "label_name": "F4",
                        "value": "heloi"
                    },
                    {
                        "column_name": "UDF_USER1",
                        "label_name": "user pick list ",
                        "value": "58045924"
                    },
                    {
                        "column_name": "UDF_DECIMAL2",
                        "label_name": "currency",
                        "value": "8,699.00"
                    },
                    {
                        "column_name": "UDF_BOOLEAN1",
                        "label_name": "check box",
                        "value": "true"
                    },
                    {
                        "column_name": "UDF_CHAR4",
                        "label_name": "phone",
                        "value": "8699"
                    },
                    {
                        "column_name": "UDF_CHAR3",
                        "label_name": "email ",
                        "value": "ranjith@zohocorp.com"
                    },
                    {
                        "column_name": "UDF_CHAR2",
                        "label_name": "pick one",
                        "value": "heloi"
                    }
                ],
                "bill_status": "Billable",
                "last_modified_time_format": "09-24-2020 10:46:27 PM",
                "task": {
                    "name": "Complete all the changes that are assigned to you on time and make them checkin to collab.",
                    "id_string": "62308000000046015",
                    "id": 62308000000046020
                },
                "log_date": "09-25-2020",
                "id_string": "62308000000701001",
                "created_date": "09-24-2020",
                "hours_display": "02:00"
            },
            {
                "notes": "timesheet log : start time -07-25-2020 07:57 PM end time 07-25-2020 08:00 PM time spent - 00.02",
                "owner_id": "60104829",
                "link": {
                    "self": {
                        "url": "https://projects.zoho.com/restapi/portal/60105112/projects/62308000000045027/tasks/62308000000046015/logs/62308000000556024/"
                    }
                },
                "last_modified_date": "07-25-2020",
                "log_date_long": 1595687245259,
                "is_parent": true,
                "sub_task_level": "0",
                "last_modified_time_long": 1595687631611,
                "id": 62308000000556024,
                "log_date_format": "07-25-2020 07:27:25 AM",
                "created_time_long": 1595687409355,
                "hours": 0,
                "owner_name": "hey ranjith",
                "created_time_format": "07-25-2020 07:30:09 AM",
                "is_sub_task": false,
                "minutes": 2,
                "total_minutes": 2,
                "approval_status": "Pending",
                "custom_fields": [],
                "end_time": "08:00 PM",
                "bill_status": "Non Billable",
                "start_time": "07:57 PM",
                "last_modified_time_format": "07-25-2020 07:33:51 AM",
                "task": {
                    "name": "Complete all the changes that are assigned to you on time and make them checkin to collab.",
                    "id_string": "62308000000046015",
                    "id": 62308000000046020
                },
                "log_date": "07-25-2020",
                "id_string": "62308000000556024",
                "created_date": "07-25-2020",
                "hours_display": "00:02"
            },
            {
                "notes": "timesheet log : start time -07-25-2020 07:56 PM end time 07-25-2020 07:57 PM time spent - 00.00",
                "owner_id": "60104829",
                "link": {
                    "self": {
                        "url": "https://projects.zoho.com/restapi/portal/60105112/projects/62308000000045027/tasks/62308000000046015/logs/62308000000556017/"
                    }
                },
                "last_modified_date": "07-25-2020",
                "log_date_long": 1595687188543,
                "is_parent": true,
                "sub_task_level": "0",
                "last_modified_time_long": 1595687231884,
                "id": 62308000000556020,
                "log_date_format": "07-25-2020 07:26:28 AM",
                "created_time_long": 1595687231884,
                "hours": 0,
                "owner_name": "hey ranjith",
                "created_time_format": "07-25-2020 07:27:11 AM",
                "is_sub_task": false,
                "minutes": 0,
                "total_minutes": 0,
                "approval_status": "Pending",
                "custom_fields": [],
                "end_time": "07:57 PM",
                "bill_status": "Non Billable",
                "start_time": "07:56 PM",
                "last_modified_time_format": "07-25-2020 07:27:11 AM",
                "task": {
                    "name": "Complete all the changes that are assigned to you on time and make them checkin to collab.",
                    "id_string": "62308000000046015",
                    "id": 62308000000046020
                },
                "log_date": "07-25-2020",
                "id_string": "62308000000556017",
                "created_date": "07-25-2020",
                "hours_display": "00:00"
            },
            {
                "notes": "timesheet log : start time -07-25-2020 07:25 PM end time 07-25-2020 07:54 PM time spent - 00.29",
                "owner_id": "60104829",
                "link": {
                    "self": {
                        "url": "https://projects.zoho.com/restapi/portal/60105112/projects/62308000000045027/tasks/62308000000046015/logs/62308000000556001/"
                    }
                },
                "last_modified_date": "07-25-2020",
                "log_date_long": 1595685319146,
                "is_parent": true,
                "sub_task_level": "0",
                "last_modified_time_long": 1595687072277,
                "id": 62308000000556000,
                "log_date_format": "07-25-2020 06:55:19 AM",
                "created_time_long": 1595687069969,
                "hours": 0,
                "owner_name": "hey ranjith",
                "created_time_format": "07-25-2020 07:24:29 AM",
                "is_sub_task": false,
                "minutes": 29,
                "total_minutes": 29,
                "approval_status": "Pending",
                "custom_fields": [],
                "end_time": "07:54 PM",
                "bill_status": "Non Billable",
                "start_time": "07:25 PM",
                "last_modified_time_format": "07-25-2020 07:24:32 AM",
                "task": {
                    "name": "Complete all the changes that are assigned to you on time and make them checkin to collab.",
                    "id_string": "62308000000046015",
                    "id": 62308000000046020
                },
                "log_date": "07-25-2020",
                "id_string": "62308000000556001",
                "created_date": "07-25-2020",
                "hours_display": "00:29"
            },
            {
                "notes": "timesheet log : start time -07-25-2020 06:53 PM end time 07-25-2020 07:23 PM time spent - 00.29",
                "owner_id": "60104829",
                "link": {
                    "self": {
                        "url": "https://projects.zoho.com/restapi/portal/60105112/projects/62308000000045027/tasks/62308000000046015/logs/62308000000555008/"
                    }
                },
                "last_modified_date": "07-25-2020",
                "log_date_long": 1595683425590,
                "is_parent": true,
                "sub_task_level": "0",
                "last_modified_time_long": 1595685190177,
                "id": 62308000000555010,
                "log_date_format": "07-25-2020 06:23:45 AM",
                "created_time_long": 1595685190177,
                "hours": 0,
                "owner_name": "hey ranjith",
                "created_time_format": "07-25-2020 06:53:10 AM",
                "is_sub_task": false,
                "minutes": 29,
                "total_minutes": 29,
                "approval_status": "Pending",
                "custom_fields": [],
                "end_time": "07:23 PM",
                "bill_status": "Non Billable",
                "start_time": "06:53 PM",
                "last_modified_time_format": "07-25-2020 06:53:10 AM",
                "task": {
                    "name": "Complete all the changes that are assigned to you on time and make them checkin to collab.",
                    "id_string": "62308000000046015",
                    "id": 62308000000046020
                },
                "log_date": "07-25-2020",
                "id_string": "62308000000555008",
                "created_date": "07-25-2020",
                "hours_display": "00:29"
            },
            {
                "notes": "timesheet log : start time -07-25-2020 06:50 PM end time 07-25-2020 06:50 PM time spent - 00.00",
                "owner_id": "60104829",
                "link": {
                    "self": {
                        "url": "https://projects.zoho.com/restapi/portal/60105112/projects/62308000000045027/tasks/62308000000046015/logs/62308000000554013/"
                    }
                },
                "last_modified_date": "07-25-2020",
                "log_date_long": 1595683220198,
                "is_parent": true,
                "sub_task_level": "0",
                "last_modified_time_long": 1595683415422,
                "id": 62308000000554020,
                "log_date_format": "07-25-2020 06:20:20 AM",
                "created_time_long": 1595683242033,
                "hours": 0,
                "owner_name": "hey ranjith",
                "created_time_format": "07-25-2020 06:20:42 AM",
                "is_sub_task": false,
                "minutes": 0,
                "total_minutes": 0,
                "approval_status": "Pending",
                "custom_fields": [],
                "end_time": "06:50 PM",
                "bill_status": "Non Billable",
                "start_time": "06:50 PM",
                "last_modified_time_format": "07-25-2020 06:23:35 AM",
                "task": {
                    "name": "Complete all the changes that are assigned to you on time and make them checkin to collab.",
                    "id_string": "62308000000046015",
                    "id": 62308000000046020
                },
                "log_date": "07-25-2020",
                "id_string": "62308000000554013",
                "created_date": "07-25-2020",
                "hours_display": "00:00"
            },
            {
                "notes": "timesheet log : start time -07-25-2020 06:46 PM end time 07-25-2020 06:47 PM time spent - 00.00",
                "owner_id": "60104829",
                "link": {
                    "self": {
                        "url": "https://projects.zoho.com/restapi/portal/60105112/projects/62308000000045027/tasks/62308000000046015/logs/62308000000554003/"
                    }
                },
                "last_modified_date": "07-25-2020",
                "log_date_long": 1595683009528,
                "is_parent": true,
                "sub_task_level": "0",
                "last_modified_time_long": 1595683021797,
                "id": 62308000000554000,
                "log_date_format": "07-25-2020 06:16:49 AM",
                "created_time_long": 1595683021797,
                "hours": 0,
                "owner_name": "hey ranjith",
                "created_time_format": "07-25-2020 06:17:01 AM",
                "is_sub_task": false,
                "minutes": 0,
                "total_minutes": 0,
                "approval_status": "Pending",
                "custom_fields": [],
                "end_time": "06:47 PM",
                "bill_status": "Non Billable",
                "start_time": "06:46 PM",
                "last_modified_time_format": "07-25-2020 06:17:01 AM",
                "task": {
                    "name": "Complete all the changes that are assigned to you on time and make them checkin to collab.",
                    "id_string": "62308000000046015",
                    "id": 62308000000046020
                },
                "log_date": "07-25-2020",
                "id_string": "62308000000554003",
                "created_date": "07-25-2020",
                "hours_display": "00:00"
            },
            {
                "notes": "timesheet log : start time -07-25-2020 06:46 PM end time 07-25-2020 06:47 PM time spent - 00.00",
                "owner_id": "60104829",
                "link": {
                    "self": {
                        "url": "https://projects.zoho.com/restapi/portal/60105112/projects/62308000000045027/tasks/62308000000046015/logs/62308000000554006/"
                    }
                },
                "last_modified_date": "07-25-2020",
                "log_date_long": 1595683009528,
                "is_parent": true,
                "sub_task_level": "0",
                "last_modified_time_long": 1595683024212,
                "id": 62308000000554010,
                "log_date_format": "07-25-2020 06:16:49 AM",
                "created_time_long": 1595683024212,
                "hours": 0,
                "owner_name": "hey ranjith",
                "created_time_format": "07-25-2020 06:17:04 AM",
                "is_sub_task": false,
                "minutes": 0,
                "total_minutes": 0,
                "approval_status": "Pending",
                "custom_fields": [],
                "end_time": "06:47 PM",
                "bill_status": "Non Billable",
                "start_time": "06:46 PM",
                "last_modified_time_format": "07-25-2020 06:17:04 AM",
                "task": {
                    "name": "Complete all the changes that are assigned to you on time and make them checkin to collab.",
                    "id_string": "62308000000046015",
                    "id": 62308000000046020
                },
                "log_date": "07-25-2020",
                "id_string": "62308000000554006",
                "created_date": "07-25-2020",
                "hours_display": "00:00"
            },
            {
                "notes": "",
                "owner_id": "60104829",
                "link": {
                    "self": {
                        "url": "https://projects.zoho.com/restapi/portal/60105112/projects/62308000000045027/tasks/62308000000046015/logs/62308000000447089/"
                    }
                },
                "last_modified_date": "05-29-2020",
                "log_date_long": 1590776999000,
                "is_parent": true,
                "sub_task_level": "0",
                "last_modified_time_long": 1590741456999,
                "id": 62308000000447090,
                "log_date_format": "05-29-2020 11:29:59 AM",
                "created_time_long": 1590741456999,
                "hours": 1,
                "cost": "₹ 5.0",
                "owner_name": "hey ranjith",
                "created_time_format": "05-29-2020 01:37:36 AM",
                "is_sub_task": false,
                "minutes": 0,
                "total_minutes": 60,
                "approval_status": "Pending",
                "custom_fields": [],
                "bill_status": "Billable",
                "last_modified_time_format": "05-29-2020 01:37:36 AM",
                "task": {
                    "name": "Complete all the changes that are assigned to you on time and make them checkin to collab.",
                    "id_string": "62308000000046015",
                    "id": 62308000000046020
                },
                "log_date": "05-29-2020",
                "id_string": "62308000000447089",
                "created_date": "05-29-2020",
                "hours_display": "01:00"
            },
            {
                "notes": "",
                "owner_id": "60104829",
                "link": {
                    "self": {
                        "url": "https://projects.zoho.com/restapi/portal/60105112/projects/62308000000045027/tasks/62308000000046015/logs/62308000000447095/"
                    }
                },
                "last_modified_date": "05-29-2020",
                "log_date_long": 1590776999000,
                "is_parent": true,
                "sub_task_level": "0",
                "last_modified_time_long": 1590741488844,
                "id": 62308000000447096,
                "log_date_format": "05-29-2020 11:29:59 AM",
                "created_time_long": 1590741488844,
                "hours": 1,
                "owner_name": "hey ranjith",
                "created_time_format": "05-29-2020 01:38:08 AM",
                "is_sub_task": false,
                "minutes": 0,
                "total_minutes": 60,
                "approval_status": "Pending",
                "custom_fields": [],
                "bill_status": "Non Billable",
                "last_modified_time_format": "05-29-2020 01:38:08 AM",
                "task": {
                    "name": "Complete all the changes that are assigned to you on time and make them checkin to collab.",
                    "id_string": "62308000000046015",
                    "id": 62308000000046020
                },
                "log_date": "05-29-2020",
                "id_string": "62308000000447095",
                "created_date": "05-29-2020",
                "hours_display": "01:00"
            },
            {
                "notes": "",
                "owner_id": "60104829",
                "link": {
                    "self": {
                        "url": "https://projects.zoho.com/restapi/portal/60105112/projects/62308000000045027/tasks/62308000000046015/logs/62308000000447101/"
                    }
                },
                "last_modified_date": "07-24-2020",
                "log_date_long": 1590776999000,
                "is_parent": true,
                "sub_task_level": "0",
                "last_modified_time_long": 1595574661966,
                "id": 62308000000447100,
                "log_date_format": "05-29-2020 11:29:59 AM",
                "created_time_long": 1590741507180,
                "hours": 1,
                "cost": "₹ 5.0",
                "owner_name": "hey ranjith",
                "created_time_format": "05-29-2020 01:38:27 AM",
                "is_sub_task": false,
                "minutes": 0,
                "total_minutes": 60,
                "approval_status": "Pending",
                "custom_fields": [
                    {
                        "column_name": "UDF_LONG1",
                        "label_name": "Number",
                        "value": "1232"
                    },
                    {
                        "column_name": "UDF_CHAR10",
                        "label_name": "url 2",
                        "value": "hey.com"
                    },
                    {
                        "column_name": "UDF_CHAR12",
                        "label_name": "single one",
                        "value": "sd"
                    },
                    {
                        "column_name": "UDF_TEXT1",
                        "label_name": "multi l;ine",
                        "value": "12323"
                    },
                    {
                        "column_name": "UDF_DATE2",
                        "label_name": "date only",
                        "value": "07-21-2020 11:30:00 AM"
                    },
                    {
                        "column_name": "UDF_DECIMAL2",
                        "label_name": "currency",
                        "value": "123.30"
                    },
                    {
                        "column_name": "UDF_CHAR4",
                        "label_name": "phone",
                        "value": "12333"
                    },
                    {
                        "column_name": "UDF_CHAR3",
                        "label_name": "email ",
                        "value": "hey@g.com"
                    }
                ],
                "bill_status": "Billable",
                "last_modified_time_format": "07-24-2020 12:11:01 AM",
                "task": {
                    "name": "Complete all the changes that are assigned to you on time and make them checkin to collab.",
                    "id_string": "62308000000046015",
                    "id": 62308000000046020
                },
                "log_date": "05-29-2020",
                "id_string": "62308000000447101",
                "created_date": "05-29-2020",
                "hours_display": "01:00"
            },
            {
                "notes": "",
                "owner_id": "60104829",
                "link": {
                    "self": {
                        "url": "https://projects.zoho.com/restapi/portal/60105112/projects/62308000000045027/tasks/62308000000046015/logs/62308000000046023/"
                    }
                },
                "last_modified_date": "12-29-2019",
                "log_date_long": 1577730599000,
                "is_parent": true,
                "sub_task_level": "0",
                "last_modified_time_long": 1577683614256,
                "invoice_id": 56928000000097064,    //for portals integrated with Zoho Invoice
                "id": 62308000000046024,
                "log_date_format": "12-30-2019 10:29:59 AM",
                "created_time_long": 1577683614256,
                "hours": 4,
                "cost": "₹ 20.0",
                "owner_name": "hey ranjith",
                "created_time_format": "12-29-2019 09:26:54 PM",
                "is_sub_task": false,
                "minutes": 0,
                "total_minutes": 240,
                "approver_name": "",
                "approval_status": "Approved",
                "custom_fields": [
                    {
                        "column_name": "UDF_BOOLEAN1",
                        "label_name": "check box",
                        "value": "true"
                    }
                ],
                "bill_status": "Billable",
                "last_modified_time_format": "12-29-2019 09:26:54 PM",
                "task": {
                    "name": "Complete all the changes that are assigned to you on time and make them checkin to collab.",
                    "id_string": "62308000000046015",
                    "id": 62308000000046020
                },
                "log_date": "12-30-2019",
                "id_string": "62308000000046023",
                "created_date": "12-29-2019",
                "hours_display": "04:00"
            }
        ]
    }
}

 Add Time Log for a Task

Adds the time log to a task.

POST  /portal/[PORTALID]/projects/[PROJECTID]/tasks/[TASKID]/logs/

Scope: ZohoProjects.timesheets.CREATE

Request Parameters

date*

String

[MM-DD-YYYY]

Date of the timesheet.
ownerLongUser ID.
bill_status*StringTimesheet billable status must be provided as Billable or Non Billable.
hours*

String

[hh:mm]

Time period of the timesheet.
notes

String

Additional information about the time log.

Sample Response

Status: 201 Created

Content Type: application/json;charset=utf-8
{
  "timelogs": {
    "tasklogs": [
      {
        "created_time_long": 1534159537786,
        "hours": 5,
        "notes": "",
        "owner_name": "Steve Young",
        "created_time_format": "08-13-2018 04:25:37 AM",
        "minutes": 0,
        "total_minutes": 300,
        "owner_id": "639283127",
        "approval_status": "Pending",
        "link": {
          "self": {
            "url": "https://projectsapi.zoho.com/restapi/portal/2063927/projects/170876000003055013/tasks/170876000005059003/logs/170876000005413001/"
          }
        },
        "last_modified_date": "08-13-2018",
        "log_date_long": 1534229999000,
        "bill_status": "billable",
        "last_modified_time_long": 1534159537786,
        "last_modified_time_format": "08-13-2018 04:25:37 AM",
        "task": {
          "name": "Build house",
          "id_string": "170876000005059003",
          "id": 170876000005059000
        },
        "log_date": "08-13-2018",
        "id_string": "170876000005413001",
        "id": 170876000005413000,
        "created_date": "08-13-2018",
        "log_date_format": "08-13-2018 11:59:59 PM",
        "hours_display": "05:00"
      }
    ]
  }
}

 Update Time Log for a Task

Updates the time log for a task

POST /portal/[PORTALID]/projects/[PROJECTID]/tasks/[TASKID]/logs/[LOGID]/

Scope: ZohoProjects.timesheets.UPDATE

Request Parameters

date*

String

[MM-DD-YYYY]

Date of the timesheet.
ownerLongUser ID.
bill_status*StringTimesheet billable status must be provided as Billable or Non Billable.
hours*

String

[hh:mm]

Time period of the timesheet.
notes

String

Additional information about the time log.

Sample Response

Status: 200 Success

Content Type: application/json;charset=utf-8
{
  "timelogs": {
    "tasklogs": [
      {
        "created_time_long": 1534159537786,
        "hours": 5,
        "notes": "",
        "owner_name": "Helen Collins",
        "created_time_format": "08-13-2018 04:25:37 AM",
        "minutes": 0,
        "total_minutes": 300,
        "owner_id": "639283127",
        "approval_status": "Pending",
        "link": {
          "self": {
            "url": "https://projectsapi.zoho.com/restapi/portal/2063927/projects/170876000003055013/tasks/170876000005059003/logs/170876000005413001/"
          }
        },
        "last_modified_date": "08-13-2018",
        "log_date_long": 1534229999000,
        "bill_status": "Non billable",
        "last_modified_time_long": 1534159703756,
        "last_modified_time_format": "08-13-2018 04:28:23 AM",
        "task": {
          "name": "Build house",
          "id_string": "170876000005059003",
          "id": 170876000005059000
        },
        "log_date": "08-13-2018",
        "id_string": "170876000005413001",
        "id": 170876000005413000,
        "created_date": "08-13-2018",
        "log_date_format": "08-13-2018 11:59:59 PM",
        "hours_display": "05:00"
      }
    ]
  }
}

 Approve Time Log for a Task

Approve time log for a task.

POST /portal/[PORTALID]/projects/[PROJECTID]/tasks/[TASKID]/logs/[LOGID]/approval

Scope: ZohoProjects.timesheets.UPDATE

Request Parameters

approvalStringAccepted values
  • approve. The time log is approved if the given value is approve. 
  • pending.
  • reject.
reasonString Reason should be mentioned if the time log is rejected. The reason shouldn't exceed 250 characters.

Sample Response

Status: 200 Success

Content Type: application/json;charset=utf-8
{
    "timelogs": {
        "tasklogs": [
            {
                "created_time_long": 1542723442883,
                "reason":"Duplicate entry",
                "hours": 1,
                "notes": "Hours for leak detection",
                "owner_name": "Patricia Boyle",
                "created_time_format": "11-20-2018 07:47:22 PM",
                "minutes": 0,
                "total_minutes": 60,
                "owner_id": "55264609",
                "approval_status": "Rejected",
                "reason": "Incorrect date"
                "link": {
                    "self": {
                        "url": "https://Zylker.com/restapi/portal/5*****/projects/3*****/tasks/3*****/logs/3****/"
                    }
                },
                "last_modified_date": "11-20-2018",
                "log_date_long": 1542133799000,
                "bill_status": "Billable",
                "last_modified_time_long": 1542723462381,
                "last_modified_time_format": "11-20-2018 07:47:42 PM",
                "task": {
                    "name": "Donnelley Apartments",
                    "id_string": "31371000000073025",
                    "id": 31371000000073025
                },
                "log_date": "11-13-2018",
                "id_string": "31371000000130005",
                "id": 31371000000130005,
                "created_date": "11-20-2018",
                "log_date_format": "11-13-2018 11:59:59 PM",
                "hours_display": "01:00"
            }
        ]
    }
}

 Delete Time Log for a Task

Deletes the time log for a task.

DELETE  /portal/[PORTALID]/projects/[PROJECTID]/tasks/[TASKID]/logs/[LOGID]/

Scope: ZohoProjects.timesheets.DELETE

Sample Response

Status: 200 Success

Content Type: application/json;charset=utf-8
{
    "response": "Timesheet log Deleted Successfully"
}

 Get Time Logs for a Bug

Gets the time logs under a specific bug.

GET  /portal/[PORTALID]/projects/[PROJECTID]/bugs/[ISSUEID]/logs

Scope: ZohoProjects.timesheets.READ

Request Parameters

indexintIndex of the time log.
rangeintRange of the time logs.

Sample Response

Status: 200 Success

Content Type: application/json;charset=utf-8
{
    "timelogs": {
        "buglogs": [
            {
                "notes": "timesheet log : start time -04-15-2020 15:19 end time 04-15-2020 15:2g",
                "owner_id": "60104829",
                "link": {
                    "self": {
                        "url": "https://projects.zoho.com/restapi/portal/cdn/projects/62308000000045027/bugs/62308000000363043/logs/62308000000363058/"
                    }
                },
                "last_modified_date": "09-28-2020",
                "log_date_long": 1587061799000,
                "last_modified_time_long": 1601285769138,
                "invoice_id": 56928000000281000,    //for portals integrated with Zoho Invoice
                "id": 62308000000363060,
                "log_date_format": "04-16-2020 11:29:59 AM",
                "created_time_long": 1586944159298,
                "hours": 2,
                "cost": "₹ 11.34",
                "owner_name": "hey ranjith",
                "created_time_format": "04-15-2020 02:49:19 AM",
                "minutes": 16,
                "total_minutes": 136,
                "approver_name": "hey ranjith",
                "approval_status": "Approved",
                "custom_fields": [
                    {
                        "column_name": "UDF_BOOLEAN1",
                        "label_name": "check box",
                        "value": "false"
                    }
                ],
                "end_time": "05:35 PM",
                "bill_status": "Billable",
                "start_time": "03:19 PM",
                "last_modified_time_format": "09-28-2020 02:36:09 AM",
                "bug": {
                    "id_string": "62308000000363043",
                    "id": 62308000000363040,
                    "title": "hel"
                },
                "log_date": "04-16-2020",
                "id_string": "62308000000363058",
                "created_date": "04-15-2020",
                "hours_display": "02:16"
            }
        ],
        "total_log_hours": "02:16"
    }
}

 Add Time Log for a Bug

Adds the time log to a bug.

POST  /portal/[PORTALID]/projects/[PROJECTID]/bugs/[BUGID]/logs/

Scope: ZohoProjects.timesheets.CREATE

Request Parameters

date*

String

[MM-DD-YYYY]

Date of the timesheet.
ownerLongUser ID.
bill_status*StringTimesheet billable status must be provided as Billable or Non Billable.
hours*

String

[hh:mm]

Time period of the timesheet.
notes

String

Additional information about the time log.

Sample Response

Status: 201 Created

Content Type: application/json;charset=utf-8
{
  "timelogs": {
    "buglogs": [
      {
        "created_time_long": 1534159650174,
        "hours": 5,
        "notes": "",
        "owner_name": "Helen Collins",
        "created_time_format": "08-13-2018 04:27:30 AM",
        "minutes": 0,
        "total_minutes": 300,
        "owner_id": "639283127",
        "approval_status": "Pending",
        "link": {
          "self": {
            "url": "https://projectsapi.zoho.com/restapi/portal/2063927/projects/170876000003055013/bugs/170876000003237035/logs/170876000005413005/"
          }
        },
        "last_modified_date": "08-13-2018",
        "log_date_long": 1531983599000,
        "bill_status": "all",
        "last_modified_time_long": 1534159650174,
        "last_modified_time_format": "08-13-2018 04:27:30 AM",
        "bug": {
          "id_string": "170876000003237035",
          "id": 170876000003237020,
          "title": "I grew up in north Philadelphia. The youngest of  three, I have two older sisters, five and eight years older than me.  In my 35 years of living, I have yet to meet my  \n"
        },
        "log_date": "07-18-2018",
        "id_string": "170876000005413005",
        "id": 170876000005413000,
        "created_date": "08-13-2018",
        "log_date_format": "07-18-2018 11:59:59 PM",
        "hours_display": "05:00"
      }
    ]
  }
}

 Update Time Log for a Bug

Updates the time log for a bug.

POST  /portal/[PORTALID]/projects/[PROJECTID]/bugs/[BUGID]/logs/[LOGID]/

Scope: ZohoProjects.timesheets.UPDATE

Request Parameters

date*

String

[MM-DD-YYYY]

Date of the timesheet.
ownerLongUser ID.
bill_status*StringTimesheet billable status must be provided as Billable or Non Billable.
hours*

String

[hh:mm]

Time period of the timesheet.
notes

String

Additional information about the time log.

Sample Response

Status: 200 Success

Content Type: application/json;charset=utf-8
{
  "timelogs": {
    "buglogs": [
      {
        "created_time_long": 1534159650174,
        "hours": 5,
        "notes": "",
        "owner_name": "Helen Collins",
        "created_time_format": "08-13-2018 04:27:30 AM",
        "minutes": 0,
        "total_minutes": 300,
        "owner_id": "639283127",
        "approval_status": "Pending",
        "link": {
          "self": {
            "url": "https://projectsapi.zoho.com/restapi/portal/2063927/projects/170876000003055013/bugs/170876000003237035/logs/170876000005413005/"
          }
        },
        "last_modified_date": "08-13-2018",
        "log_date_long": 1531983599000,
        "bill_status": "billable",
        "last_modified_time_long": 1534159817712,
        "last_modified_time_format": "08-13-2018 04:30:17 AM",
        "bug": {
          "id_string": "170876000003237035",
          "id": 170876000003237020,
          "title": "I grew up in north Philadelphia. The youngest of  three, I have two older sisters, five and eight years older than me.  In my 35 years of living, I have yet to meet my  \n"
        },
        "log_date": "07-18-2018",
        "id_string": "170876000005413005",
        "id": 170876000005413000,
        "created_date": "08-13-2018",
        "log_date_format": "07-18-2018 11:59:59 PM",
        "hours_display": "05:00"
      }
    ]
  }
}

 Approve Time Log for a Bug

Approve time log for a bug.

POST  /portal/[PORTALID]/projects/[PROJECTID]/bugs/[BUGID]/logs/[LOGID]/approval

Scope: ZohoProjects.timesheets.UPDATE

Request Parameters

approvalStringAccepted values
  • approve. The time log is approved if the given value is approve. 
  • pending.
  • reject.
reasonString Reason should be mentioned if the time log is rejected. The reason shouldn't exceed 250 characters.

Sample Response

Status: 200 Success

Content Type: application/json;charset=utf-8
{
    "timelogs": {
        "buglogs": [{
            "bug": {
                "id": 170876000001829171,
                "name": "UI Issue in Gantt"
            },
            "approval_status": "Approved"
            "id": 170876000001849055,
            "notes": "",
            "log_date": "05-26-2014 11:59 PM",
            "log_date_long": 1401157799000,
            "hours": 3,
            "minutes": 30,
            "hours_display": "03:30",
            "total_minutes": 210,
            "owner_id": "2060758",
            "owner_name": "Patricia Boyle",
            "bill_status": "Billable",
            "link": {
                "self": {
                    "url": "https://projectsapi.zoho.com/restapi/portal/2063927/projects/170876000000147021/bugs/170876000001829171/logs/170876000001849055/"
                }
            }
        }]
    }
}

 Delete Time Log for a Bug

Deletes the time log for a bug.

DELETE  /portal/[PORTALID]/projects/[PROJECTID]/bugs/[BUGID]/logs/[LOGID]/

Scope: ZohoProjects.timesheets.DELETE

Sample Response

Status: 200 Success

Content Type: application/json;charset=utf-8
{
    "response": "Timesheet log Deleted Successfully"
}

 Add Time for a General Log

Adds the time log to other tasks.

POST  /portal/[PORTALID]/projects/[PROJECTID]/logs/

Scope: ZohoProjects.timesheets.CREATE

Request Parameters

name*

String

Name of the other tasks.
ownerLongUser ID.
date*

String

[MM-DD-YYYY]

Date of the timesheet.
bill_status*StringTimesheet billable status must be provided as Billable or Non Billable.
hours*

String

[hh:mm]

Time period of the timesheet.
notes

String

Additional information about the time log.

Sample Response

Status: 201 Created

Content Type: application/json;charset=utf-8
{
  "timelogs": {
    "generallogs": [
      {
        "created_time_long": 1534159664291,
        "hours": 5,
        "notes": "",
        "owner_name": "Helen Collins",
        "created_time_format": "08-13-2018 04:27:44 AM",
        "minutes": 0,
        "total_minutes": 300,
        "owner_id": "639283127",
        "approval_status": "Pending",
        "link": {
          "self": {
            "url": "https://projectsapi.zoho.com/restapi/portal/2063927/projects/170876000003055013/logs/170876000005413009/"
          }
        },
        "last_modified_date": "08-13-2018",
        "log_date_long": 1531983599000,
        "bill_status": "all",
        "last_modified_time_long": 1534159664291,
        "last_modified_time_format": "08-13-2018 04:27:44 AM",
        "log_date": "07-18-2018",
        "name": "general-log",
        "id_string": "170876000005413009",
        "id": 170876000005413020,
        "created_date": "08-13-2018",
        "log_date_format": "07-18-2018 11:59:59 PM",
        "hours_display": "05:00"
      }
    ]
  }
}

 Update Time for a General Log

Updates the time log for other tasks.

POST  /portal/[PORTALID]/projects/[PROJECTID]/logs/[LOGID]/

Scope: ZohoProjects.timesheets.UPDATE

Request Parameters

name*

String

Name of the other tasks.
ownerLongUser ID.
date*

String

[MM-DD-YYYY]

Date of the timesheet.
bill_status*StringTimesheet billable status must be provided as Billable or Non Billable.
hours*

String

[hh:mm]

Time period of the timesheet.
notes

String

Additional information about the time log.

Sample Response

Status: 200 Success

Content Type: application/json;charset=utf-8
{
  "timelogs": {
    "generallogs": [
      {
        "created_time_long": 1534159664291,
        "hours": 10,
        "notes": "",
        "owner_name": "Helen Collins",
        "created_time_format": "08-13-2018 04:27:44 AM",
        "minutes": 0,
        "total_minutes": 600,
        "owner_id": "639283127",
        "approval_status": "Pending",
        "link": {
          "self": {
            "url": "https://projectsapi.zoho.com/restapi/portal/2063927/projects/170876000003055013/logs/170876000005413009/"
          }
        },
        "last_modified_date": "08-13-2018",
        "log_date_long": 1531983599000,
        "bill_status": "all",
        "last_modified_time_long": 1534159890445,
        "last_modified_time_format": "08-13-2018 04:31:30 AM",
        "log_date": "07-18-2018",
        "name": "general-log",
        "id_string": "170876000005413009",
        "id": 170876000005413020,
        "created_date": "08-13-2018",
        "log_date_format": "07-18-2018 11:59:59 PM",
        "hours_display": "10:00"
      }
    ]
  }
}

 Approve Time for a General Log

Approve general time log.

POST  /portal/[PORTALID]/projects/[PROJECTID]/logs/[LOGID]/approval

Scope: ZohoProjects.timesheets.UPDATE

Request Parameters

approvalStringAccepted values
  • approve. The time log is approved if the given value is approve. 
  • pending.
  • reject.
reasonString Reason should be mentioned if the time log is rejected. The reason shouldn't exceed 250 characters.

Sample Response

Status: 200 Success

Content Type: application/json;charset=utf-8
{
    "timelogs": {
        "generallogs": [{
            "approval_status": "Approved"
            "id": 170876000001849059,
            "name": "Client Call",
            "notes": "",
            "log_date": "05-26-2014 11:59 PM",
            "log_date_long": 1401157799000,
            "hours": 2,
            "minutes": 30,
            "hours_display": "02:30",
            "total_minutes": 150,
            "owner_id": "2060758",
            "owner_name": "Patricia Boyle",
            "bill_status": "Billable",
            "link": {
                "self": {
                    "url": "https://projectsapi.zoho.com/restapi/portal/2063927/projects/170876000000147021/logs/170876000001849059/"
                }
            }
        }]
    }
}

 Delete Time for a General Log

Deletes the time log for other tasks.

DELETE  /portal/[PORTALID]/projects/[PROJECTID]/logs/[LOGID]/

Scope: ZohoProjects.timesheets.DELETE

Sample Response

Status: 200 Success

Content Type: application/json;charset=utf-8
{
    "response": "Timesheet log Deleted Successfully"
}

Share this post : FacebookTwitter

Still can't find what you're looking for?

Write to us: support@zohoprojects.com