Tasks
A project comprises of a single or multiple tasks that need to be completed. You need to add a task to the project before you log time.
End Points
Add a task
List tasks
Update a task
Get a task
Delete a Task
Attribute
project_id
string
Unique ID of the project generated by the server.
task_id
string
Unique ID of the task generated by the server.
currency_id
string
The currenct ID of the currency
customer_id
string
Customer ID of the customer for whom the task is created.
task_name
string
The name of the task.
Maximum length [100] project_name
string
The name of the project
customer_name
string
Name of the customer to whom the task is created.
billed_hours
double
The total hours that are billed.
log_time
double
Total hours logged in the project.
un_billed_hours
double
Total hours that are unbilled.
{
"project_id": "90300000072369",
"task_id": "90300000072369",
"currency_id": 982000000000190,
"customer_id": "903000000000099",
"task_name": "Painting",
"project_name": "Furniture Manufacturing",
"customer_name": "David Sujin",
"billed_hours": "12:06",
"log_time": "13:06",
"un_billed_hours": "01:00"
}
Add a task
Adding a new task to a project. oauthscope : ZohoInvoice.projects.CREATE
Arguments
task_name
string
(Required)
The name of the task.
Maximum length [100] description
string
The description of the project.
rate
integer
Hourly rate for a task.
budget_hours
integer
Task budget hours.
$ curl https://invoice.zoho.com/api/v3/projects/{project_id}/tasks
-X POST
-H "X-com-zoho-invoice-organizationid: 10234695"
-H "Content-Type: application/json;charset=UTF-8"
-H "Authorization: Zoho-oauthtoken 1000.41d9f2cfbd1b7a8f9e314b7aff7bc2d1.8fcc9810810a216793f385b9dd6e125f"
-d '{"field":"value","field":"value"}'
{
"task_name": "Painting",
"description": "",
"rate": 3,
"budget_hours": ""
}
{
"code": 0,
"message": "The task has been added.",
"task": {
"project_id": "90300000072369",
"task_id": "90300000072369",
"currency_id": 982000000000190,
"customer_id": "903000000000099",
"task_name": "Painting",
"project_name": "Furniture Manufacturing",
"customer_name": "David Sujin",
"billed_hours": "12:06",
"log_time": "13:06",
"un_billed_hours": "01:00"
}
}
List tasks
Get list of all the tasks added to a project. oauthscope : ZohoInvoice.projects.READ
$ curl https://invoice.zoho.com/api/v3/projects/{project_id}/tasks
-H "X-com-zoho-invoice-organizationid: 10234695"
-H "Authorization: Zoho-oauthtoken 1000.41d9f2cfbd1b7a8f9e314b7aff7bc2d1.8fcc9810810a216793f385b9dd6e125f"
{
"code": 0,
"message": "success",
"tasks": [
{
"project_id": "90300000072369",
"task_id": "90300000072369",
"currency_id": 982000000000190,
"customer_id": "903000000000099",
"task_name": "Painting",
"project_name": "Furniture Manufacturing",
"customer_name": "David Sujin",
"billed_hours": "12:06",
"log_time": "13:06",
"un_billed_hours": "01:00"
},
{...},
{...}
]
}
Update a task
Update the details of an existing task. oauthscope : ZohoInvoice.projects.UPDATE
Arguments
task_name
string
(Required)
The name of the task.
Maximum length [100] description
string
The description of the project.
rate
integer
Hourly rate for a task.
budget_hours
integer
Task budget hours.
$ curl https://invoice.zoho.com/api/v3/projects/{project_id}/tasks/{task_id}
-X PUT
-H "X-com-zoho-invoice-organizationid: 10234695"
-H "Content-Type: application/json;charset=UTF-8"
-H "Authorization: Zoho-oauthtoken 1000.41d9f2cfbd1b7a8f9e314b7aff7bc2d1.8fcc9810810a216793f385b9dd6e125f"
-d '{"field":"value","field":"value"}'
{
"task_name": "Painting",
"description": "",
"rate": 3,
"budget_hours": ""
}
{
"code": 0,
"message": "The task information has been updated.",
"task": {
"project_id": "90300000072369",
"task_id": "90300000072369",
"currency_id": 982000000000190,
"customer_id": "903000000000099",
"task_name": "Painting",
"project_name": "Furniture Manufacturing",
"customer_name": "David Sujin",
"billed_hours": "12:06",
"log_time": "13:06",
"un_billed_hours": "01:00"
}
}
Get a task
Get the details of a task. oauthscope : ZohoInvoice.projects.READ
$ curl https://invoice.zoho.com/api/v3/projects/{project_id}/tasks/{task_id}
-H "X-com-zoho-invoice-organizationid: 10234695"
-H "Authorization: Zoho-oauthtoken 1000.41d9f2cfbd1b7a8f9e314b7aff7bc2d1.8fcc9810810a216793f385b9dd6e125f"
{
"code": 0,
"message": "success",
"task": {
"project_id": "90300000072369",
"project_name": "Furniture Manufacturing",
"task_id": "90300000072369",
"task_name": "Painting",
"description": "",
"rate": 3,
"status": "active",
"is_billable": true
}
}
Delete a Task
Delete a task added to a project. oauthscope : ZohoInvoice.projects.DELETE
$ curl https://invoice.zoho.com/api/v3/projects/{project_id}/tasks/{task_id}
-X DELETE
-H "X-com-zoho-invoice-organizationid: 10234695"
-H "Authorization: Zoho-oauthtoken 1000.41d9f2cfbd1b7a8f9e314b7aff7bc2d1.8fcc9810810a216793f385b9dd6e125f"
{
"code": 0,
"message": "The task has been deleted successfully."
}