Time Tracking API | Zoho Projects

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 /restapi/portal/[PORTALID]/projects/[PROJECTID]/logs/

Get My Time Logs
GET /restapi/portal/[PORTALID]/logs

Get Time Logs for a Task
GET /restapi/portal/[PORTALID]/projects/[PROJECTID]/tasks/[TASKID]/logs/

Add Time Log for a Task
POST /restapi/portal/[PORTALID]/projects/[PROJECTID]/tasks/[TASKID]/logs/

Update Time Log for a Task
POST /restapi/portal/[PORTALID]/projects/[PROJECTID]/tasks/[TASKID]/logs/[LOGID]/

Approve Time Log for a Task
POST /restapi/portal/[PORTALID]/projects/[PROJECTID]/tasks/[TASKID]/logs/[LOGID]/approval

Delete Time Log for a Task
DELETE /restapi/portal/[PORTALID]/projects/[PROJECTID]/tasks/[TASKID]/logs/[LOGID]/

Get Time Logs for a Bug
GET /restapi/portal/[PORTALID]/projects/[PROJECTID]/bugs/[ISSUEID]/logs

Add Time Log for a Bug
POST /restapi/portal/[PORTALID]/projects/[PROJECTID]/bugs/[BUGID]/logs/

Update Time Log for a Bug
POST /restapi/portal/[PORTALID]/projects/[PROJECTID]/bugs/[BUGID]/logs/[LOGID]/

Approve Time Log for a Bug
POST /restapi/portal/[PORTALID]/projects/[PROJECTID]/bugs/[BUGID]/logs/[LOGID]/approval

Delete Time Log for a Bug
DELETE /restapi/portal/[PORTALID]/projects/[PROJECTID]/bugs/[BUGID]/logs/[LOGID]/

Add Time for a General Log
POST /restapi/portal/[PORTALID]/projects/[PROJECTID]/logs/

Update Time for a General Log
POST /restapi/portal/[PORTALID]/projects/[PROJECTID]/logs/[LOGID]/

Approve Time for a General Log
POST /restapi/portal/[PORTALID]/projects/[PROJECTID]/logs/[LOGID]/approval

Delete Time for a General Log
DELETE /restapi/portal/[PORTALID]/projects/[PROJECTID]/logs/[LOGID]/

Get Timesheet Layout Details
GET /restapi/portal/[PORTALID]/projects/[PROJECTID]/timesheetlayouts

Get All Timesheet Custom Fields
GET /restapi/portal/[PORTALID]/timesheetcustomfields

Get All Time Logs

Gets all the time logs in the given project.

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

Scope: ZohoProjects.timesheets.READ

Request Parameters

index	int	Index of the time log.
range	int	Range of the time logs.
users_list*	String or Long	User 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*	String	View type of the timesheet must be provided as day or week or month or custom_date
date*	String [MM-DD-YYYY]	Date of the timesheet view type.
custom_date	JSON Object	Range of the custom_date. The date range must not exceed 6 months. Format: {"start_date": "MM-DD-YYYY", "end_date": "MM-DD-YYYY"}. Mandatory parameter when view type is selected as custom_date.
bill_status*	String	Timesheet billable status must be provided as All or Billable or Non Billable.
component_type*	String	Type of the component must be provided as task or bug or general.
approval_status	String	Accepted values approved pending rejected all
fetch_by_modifiedtime	Boolean	Value must be provided as true or false.

Sample Response

Status: 200 Success

Content Type: application/json;charset=utf-8

{
    "timelogs": {
        "date": [
            {
                "date": "03-19-2021",
                "display_format": "03-19-2021 12:00:00 AM",
                "date_long": 1616092200000,
                "total_hours": "4:30",
                "tasklogs": [
                    {
                        "created_time_long": 1617004794745,
                        "hours": 4,
                        "notes": "",
                        "owner_name": "Monica Hemsworth",
                        "created_time_format": "03-29-2021 01:29:54 PM",
                        "minutes": 30,
                        "total_minutes": 270,
                        "owner_id": "703961433",
                        "approval_status": "Approved",
                        "approver_name": "Monica Hemsworth",
                        "link": {
                            "self": {
                                "url": "https://projectsapi.zoho.com/restapi/portal/zylker/projects/170876000010385143/tasks/170876000010385343/logs/170876000010969001/"
                            }
                        },
                        "last_modified_date": "03-29-2021",
                        "bill_status": "Billable",
                        "last_modified_time_long": 1617005067402,
                        "last_modified_time_format": "03-29-2021 01:34:27 PM",
                        "task": {
                            "sub_task_level": "0",
                            "is_sub_task": false,
                            "name": "Addition exercice",
                            "id_string": "170876000010385343",
                            "id": 170876000010385343,
                            "is_parent": false
                        },
                        "id_string": "170876000010969001",
                        "created_date": "03-29-2021",
                        "id": 170876000010969001,
                        "hours_display": "04:30",
                        "task_list": {
                            "name": "Math",
                            "id": 170876000010385293
                        }
                    }
                ]
            }
        ],
        "role": "admin",
        "non_billable_hours": "00:00",
        "billable_hours": "04:30",
        "grandtotal": "04:30"
    }
}

Get My Time Logs

Gets the time logs of all users or specific users.

GET /restapi/portal/[PORTALID]/logs

Scope: ZohoProjects.timesheets.READ

Request Parameters

index	int	Index of the time log.
range	int	Range of the time logs.
users_list*	String or Long	User 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*	String	View type of the timesheet must be provided as day or week or month or custom_date
date*	String [MM-DD-YYYY]	Date of the timesheet view type.
custom_date	JSON Object	Range of the custom_date. The date range must not exceed 6 months. Format: {"start_date": "MM-DD-YYYY", "end_date": "MM-DD-YYYY"}. Mandatory parameter when view type is selected as custom_date.
bill_status*	String	Timesheet billable status must be provided as All or Billable or Non Billable.
component_type*	String	Type of the component must be provided as task or bug or general.
approval_status	String	Accepted values approved pending rejected all
fetch_by_modifiedtime	Boolean	Value must be provided as true or false.

Sample Response

Status: 200 Success

Content Type: application/json;charset=utf-8

{
  "timelogs": {
    "date": [
      {
        "date": "03-12-2021",
        "display_format": "03-12-2021 12:00:00 AM",
        "date_long": 1615487400000,
        "total_hours": "4:00",
        "tasklogs": [
          {
            "created_time_long": 1615538447501,
            "hours": 4,
            "notes": "",
            "owner_name": "Shoba S",
            "created_time_format": "03-12-2021 02:10:47 PM",
            "minutes": 0,
            "total_minutes": 240,
            "owner_id": "672004944",
            "approval_status": "Approved",
            "approver_name": "Shoba S",
            "custom_fields": [],
            "link": {
              "self": {
                "url": "https://projectsapi.zoho.com/restapi/portal/zylker/projects/170876000007103005/tasks/170876000008213022/logs/170876000010826021/"
              }
            },
            "last_modified_date": "03-12-2021",
            "project": {
              "name": "Zylker Coffee Shop",
              "id_string": "170876000007103005",
              "id": 170876000007103000
            },
            "bill_status": "Non Billable",
            "last_modified_time_long": 1615538486728,
            "last_modified_time_format": "03-12-2021 02:11:26 PM",
            "task": {
              "sub_task_level": "0",
              "is_sub_task": false,
              "name": "Task 43",
              "id_string": "170876000008213022",
              "id": 170876000008213020,
              "is_parent": false
            },
            "id_string": "170876000010826021",
            "created_date": "03-12-2021",
            "id": 170876000010826020,
            "hours_display": "04:00",
            "task_list": {
              "name": "General",
              "id": 170876000008213020
            }
          }
        ]
      }
    ],
    "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 /restapi/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": "2:00",
        "tasklogs": [
            {
                "notes": "",
                "owner_id": "703961433",
                "link": {
                    "self": {
                        "url": "https://projectsapi.zoho.com/restapi/portal/zylker/projects/170876000010385143/tasks/170876000010385343/logs/170876000010969001/"
                    }
                },
                "last_modified_date": "03-29-2021",
                "log_date_long": 1616696999000,
                "is_parent": false,
                "sub_task_level": "0",
                "last_modified_time_long": 1617004794745,
                "id": 170876000010969001,
                "task_list": {
                    "name": "Math",
                    "id": 170876000010385293
                },
                "log_date_format": "03-25-2021 11:59:59 PM",
                "created_time_long": 1617004794745,
                "hours": 2,
                "owner_name": "Monica Hemsworth",
                "created_time_format": "03-29-2021 01:29:54 PM",
                "is_sub_task": false,
                "minutes": 0,
                "total_minutes": 120,
                "approval_status": "Pending",
                "bill_status": "Billable",
                "last_modified_time_format": "03-29-2021 01:29:54 PM",
                "task": {
                    "name": "Addition exercice",
                    "id_string": "170876000010385343",
                    "id": 170876000010385343
                },
                "log_date": "03-25-2021",
                "id_string": "170876000010969001",
                "created_date": "03-29-2021",
                "hours_display": "02:00"
            }
        ]
    }
}

Add Time Log for a Task

Adds the time log to a task.

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

Scope: ZohoProjects.timesheets.CREATE

Request Parameters

date*	String [MM-DD-YYYY]	Date of the timesheet.
owner	Long	User ID.
bill_status*	String	Timesheet 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.
custom_fields	JSON Object	Value of the custom field. Example: {"UDF_CHAR1":"Hello"}
cost_per_hour	float	Specify the Cost per hour.

Sample Response

Status: 201 Created

Content Type: application/json;charset=utf-8

{
    "timelogs": {
        "tasklogs": [
            {
                "notes": "",
                "owner_id": "703961433",
                "link": {
                    "self": {
                        "url": "https://projectsapi.zoho.com/restapi/portal/zylker/projects/170876000010385143/tasks/170876000010385343/logs/170876000010969001/"
                    }
                },
                "last_modified_date": "03-29-2021",
                "log_date_long": 1616696999000,
                "is_parent": false,
                "sub_task_level": "0",
                "last_modified_time_long": 1617004794745,
                "id": 170876000010969001,
                "task_list": {
                    "name": "Math",
                    "id": 170876000010385293
                },
                "log_date_format": "03-25-2021 11:59:59 PM",
                "created_time_long": 1617004794745,
                "hours": 2,
                "owner_name": "Monica Hemsworth",
                "created_time_format": "03-29-2021 01:29:54 PM",
                "is_sub_task": false,
                "minutes": 0,
                "total_minutes": 120,
                "approval_status": "Pending",
                "bill_status": "Billable",
                "last_modified_time_format": "03-29-2021 01:29:54 PM",
                "task": {
                    "name": "Addition exercice",
                    "id_string": "170876000010385343",
                    "id": 170876000010385343
                },
                "log_date": "03-25-2021",
                "id_string": "170876000010969001",
                "created_date": "03-29-2021",
                "hours_display": "02:00"
            }
        ]
    }
}

Update Time Log for a Task

Updates the time log for a task

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

Scope: ZohoProjects.timesheets.UPDATE

Request Parameters

date*	String [MM-DD-YYYY]	Date of the timesheet.
owner	Long	User ID.
bill_status*	String	Timesheet 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.
custom_fields	JSON Object	Value of the custom field. Example: {"UDF_CHAR1":"Hello"}
cost_per_hour	float	Specify the Cost per hour.

Sample Response

Status: 200 Success

Content Type: application/json;charset=utf-8

{
    "timelogs": {
        "tasklogs": [
            {
                "notes": "",
                "owner_id": "703961433",
                "link": {
                    "self": {
                        "url": "https://projectsapi.zoho.com/restapi/portal/zylker/projects/170876000010385143/tasks/170876000010385343/logs/170876000010969001/"
                    }
                },
                "last_modified_date": "03-29-2021",
                "log_date_long": 1616178599000,
                "is_parent": false,
                "sub_task_level": "0",
                "last_modified_time_long": 1617005022730,
                "id": 170876000010969001,
                "task_list": {
                    "name": "Math",
                    "id": 170876000010385293
                },
                "log_date_format": "03-19-2021 11:59:59 PM",
                "created_time_long": 1617004794745,
                "hours": 4,
                "owner_name": "Monica Hemsworth",
                "created_time_format": "03-29-2021 01:29:54 PM",
                "is_sub_task": false,
                "minutes": 30,
                "total_minutes": 270,
                "approval_status": "Pending",
                "bill_status": "Billable",
                "last_modified_time_format": "03-29-2021 01:33:42 PM",
                "task": {
                    "name": "Addition exercice",
                    "id_string": "170876000010385343",
                    "id": 170876000010385343
                },
                "log_date": "03-19-2021",
                "id_string": "170876000010969001",
                "created_date": "03-29-2021",
                "hours_display": "04:30"
            }
        ]
    }
}

Approve Time Log for a Task

Approve time log for a task.

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

Scope: ZohoProjects.timesheets.UPDATE

Request Parameters

approval

String

Accepted values

approve. The time log is approved if the given value is approve.
pending.
reject.

reason

String

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": [
            {
                "notes": "",
                "owner_id": "703961433",
                "link": {
                    "self": {
                        "url": "https://projectsapi.zoho.com/restapi/portal/zylker/projects/170876000010385143/tasks/170876000010385343/logs/170876000010969001/"
                    }
                },
                "last_modified_date": "03-29-2021",
                "log_date_long": 1616178599000,
                "is_parent": false,
                "sub_task_level": "0",
                "last_modified_time_long": 1617005067402,
                "id": 170876000010969001,
                "task_list": {
                    "name": "Math",
                    "id": 170876000010385293
                },
                "log_date_format": "03-19-2021 11:59:59 PM",
                "created_time_long": 1617004794745,
                "hours": 4,
                "owner_name": "Monica Hemsworth",
                "created_time_format": "03-29-2021 01:29:54 PM",
                "is_sub_task": false,
                "minutes": 30,
                "total_minutes": 270,
                "approver_name": "Monica Hemsworth",
                "approval_status": "Approved",
                "bill_status": "Billable",
                "last_modified_time_format": "03-29-2021 01:34:27 PM",
                "task": {
                    "name": "Addition exercice",
                    "id_string": "170876000010385343",
                    "id": 170876000010385343
                },
                "log_date": "03-19-2021",
                "id_string": "170876000010969001",
                "created_date": "03-29-2021",
                "hours_display": "04:30"
            }
        ]
    }
}

Delete Time Log for a Task

Deletes the time log for a task.

DELETE /restapi/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 /restapi/portal/[PORTALID]/projects/[PROJECTID]/bugs/[ISSUEID]/logs

Scope: ZohoProjects.timesheets.READ

Request Parameters

index	int	Index of the time log.
range	int	Range 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 /restapi/portal/[PORTALID]/projects/[PROJECTID]/bugs/[BUGID]/logs/

Scope: ZohoProjects.timesheets.CREATE

Request Parameters

date*	String [MM-DD-YYYY]	Date of the timesheet.
owner	Long	User ID.
bill_status*	String	Timesheet 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.
custom_fields	JSON Object	Value of the custom field. Example: {"UDF_CHAR1":"Hello"}
cost_per_hour	float	Specify the Cost per hour.

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 /restapi/portal/[PORTALID]/projects/[PROJECTID]/bugs/[BUGID]/logs/[LOGID]/

Scope: ZohoProjects.timesheets.UPDATE

Request Parameters

date*	String [MM-DD-YYYY]	Date of the timesheet.
owner	Long	User ID.
bill_status*	String	Timesheet 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.
custom_fields	JSON Object	Value of the custom field. Example: {"UDF_CHAR1":"Hello"}
cost_per_hour	float	Specify the Cost per hour.

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 /restapi/portal/[PORTALID]/projects/[PROJECTID]/bugs/[BUGID]/logs/[LOGID]/approval

Scope: ZohoProjects.timesheets.UPDATE

Request Parameters

approval

String

Accepted values

approve. The time log is approved if the given value is approve.
pending.
reject.

reason

String

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 /restapi/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 /restapi/portal/[PORTALID]/projects/[PROJECTID]/logs/

Scope: ZohoProjects.timesheets.CREATE

Request Parameters

name*	String	Name of the other tasks.
owner	Long	User ID.
date*	String [MM-DD-YYYY]	Date of the timesheet.
bill_status*	String	Timesheet 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.
custom_fields	JSON Object	Value of the custom field. Example: {"UDF_CHAR1":"Hello"}

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 /restapi/portal/[PORTALID]/projects/[PROJECTID]/logs/[LOGID]/

Scope: ZohoProjects.timesheets.UPDATE

Request Parameters

name*	String	Name of the other tasks.
owner	Long	User ID.
date*	String [MM-DD-YYYY]	Date of the timesheet.
bill_status*	String	Timesheet 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.
custom_fields	JSON Object	Value of the custom field. Example: {"UDF_CHAR1":"Hello"}

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 /restapi/portal/[PORTALID]/projects/[PROJECTID]/logs/[LOGID]/approval

Scope: ZohoProjects.timesheets.UPDATE

Request Parameters

approval

String

Accepted values

approve. The time log is approved if the given value is approve.
pending.
reject.

reason

String

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 /restapi/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"
}

Get Timesheet Layout Details

Fetch details of the timesheet layout in the given project

GET /restapi/portal/[PORTALID]/projects/[PROJECTID]/timesheetlayouts

Scope: ZohoProjects.timesheets.READ

Sample Response

Status: 200 Success

Content Type: application/json;charset=utf-8

{

    "CURRENCY": "EUR",

    "layout_id": "69822000000206063",

    "section_details": [

        {

            "section_id": "69822000000206065",

            "section_name": "zp.customfields.defaulttimesheetsection",

            "customfield_details": [

                {

                    "is_pii": false,

                    "is_encrypted": false,

                    "pcfid": "69822000000073013",

                    "column_name": "LOGDATE",

                    "is_mandatory": true,

                    "is_default": true,

                    "display_name": "zp.general.date",

                    "column_type": "date"

                },

                {

                    "is_pii": false,

                    "is_encrypted": false,

                    "pcfid": "69822000000073011",

                    "column_name": "USER",

                    "is_mandatory": true,

                    "is_default": true,

                    "display_name": "zp.general.user",

                    "column_type": "userpicklist"

                },

                {

                    "is_pii": false,

                    "is_encrypted": false,

                    "pcfid": "69822000000073019",

                    "column_name": "DAILYLOG",

                    "is_mandatory": true,

                    "is_default": true,

                    "display_name": "zp.loghourrestriction.dailylog",

                    "column_type": "decimal"

                },

                {

                    "picklist_details": [

                        "zp.timesheet.billable",

                        "zp.timesheet.nonbillable"

                    ],

                    "picklist_usermap": [],

                    "is_pii": false,

                    "is_encrypted": false,

                    "pcfid": "69822000000073017",

                    "column_name": "BILLING",

                    "default_value": "zp.timesheet.billable",

                    "is_mandatory": false,

                    "is_default": true,

                    "display_name": "zp.timesheet.taskbill",

                    "column_type": "picklist"

                },

                {

                    "picklist_details": [

                        "zp.timesheet.approved",

                        "zp.timesheet.unapproved",

                        "zp.timesheet.rejected"

                    ],

                    "picklist_usermap": [],

                    "is_pii": false,

                    "is_encrypted": false,

                    "pcfid": "69822000000073021",

                    "column_name": "APPROVAL",

                    "is_mandatory": false,

                    "is_default": true,

                    "display_name": "zp.customfields.approval",

                    "column_type": "picklist"

                },

                {

                    "is_pii": false,

                    "is_encrypted": false,

                    "pcfid": "69822000000073023",

                    "column_name": "LOGCOST",

                    "is_mandatory": false,

                    "is_default": true,

                    "display_name": "zp.formulaDefault.logcost",

                    "column_type": "decimal"

                },

                {

                    "is_pii": false,

                    "is_encrypted": false,

                    "pcfid": "69822000000760039",

                    "column_name": "UDF_LONG4",

                    "is_mandatory": false,

                    "is_default": false,

                    "display_name": "number",

                    "column_type": "int"

                },

                {

                    "is_pii": false,

                    "is_encrypted": false,

                    "pcfid": "69822000000073015",

                    "column_name": "LOGNOTES",

                    "is_mandatory": true,

                    "is_default": true,

                    "display_name": "Notes",

                    "column_type": "multiline"

                }

            ],

            "is_default": false

        },

        {

            "section_id": "69822000000206067",

            "section_name": "Untitled Section ",

            "customfield_details": [

                {

                    "is_pii": false,

                    "is_encrypted": false,

                    "pcfid": "69822000000917052",

                    "column_name": "UDF_CHAR14",

                    "is_mandatory": false,

                    "is_default": false,

                    "display_name": "My Field",

                    "column_type": "singleline"

                },

                {

                    "is_pii": false,

                    "is_encrypted": false,

                    "pcfid": "69822000000917050",

                    "column_name": "UDF_DATE4",

                    "is_mandatory": false,

                    "is_default": false,

                    "display_name": "My Date",

                    "column_type": "date"

                },

                {

                    "is_pii": false,

                    "is_encrypted": false,

                    "pcfid": "69822000000918013",

                    "column_name": "UDF_CHAR14",

                    "is_mandatory": false,

                    "is_default": false,

                    "display_name": "My Field",

                    "column_type": "singleline"

                }

            ],

            "is_default": false

        }

    ],

    "currency": "€"

}

Get All Timesheet Custom Fields

Fetch all timesheet custom fields across the project

GET /restapi/portal/[PORTALID]/timesheetcustomfields

Scope: ZohoProjects.timesheets.READ

Sample Response

Status: 200 Success

Content Type: application/json;charset=utf-8

{

        "data_type": "plain_text",

        "id": "69822000000187051",

        "unique_column": "UDF_CHAR1",

        "field_name": "My Single Line"

    },

    {

        "data_type": "text",

        "id": "69822000000187053",

        "unique_column": "UDF_TEXT1",

        "field_name": "My Multi Line"

    },

    {

        "data_type": "double",

        "id": "69822000000276001",

        "unique_column": "UDF_DECIMAL1",

        "field_name": "My Currency"

    },

    {

        "data_type": "date",

        "id": "69822000000291001",

        "unique_column": "UDF_DATE1",

        "field_name": "My Date"

    }