How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Zoho Inventory Tasks API

Task Module

Zoho Inventory Tasks API is one of 37 APIs that Zoho Inventory publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

This API exposes 1 JSON Schema definition.

Tagged areas include Task. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and 1 JSON Schema.

This API exposes 17 operations across 10 paths, and defines 107 schemas. It is described by OpenAPI 3.2.0, at version 1.0.0.

Requests are made against a single base URL, https://www.zohoapis.com/inventory/v1.

17 operations 10 paths 107 schemas 4 DELETE4 GET7 POST2 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
1.0.0
Base URL
https://www.zohoapis.com/inventory/v1
Authentication
OAuth 2.0
Resource Areas
1

Authentication & Security 1

Zoho Inventory Tasks API declares 1 security scheme for authenticating requests. It supports OAuth 2.0 (Zoho_Auth) using the implicit flow, exposing 4 scopes.

Paths & Operations 17

Across 10 paths, the API surfaces 17 operations — 4 DELETE, 4 GET, 7 POST, 2 PUT. Each is listed below with its method, path, parameters, and response codes.

Tasks 17

Task Module

POST
/tasks
Add a task
add_task 1 param body → 201
GET
/tasks
List tasks
list_tasks 26 params → 200
PUT
/tasks
Update tasks
update_tasks 2 params body → 200
DELETE
/tasks
Delete tasks
delete_tasks 2 params → 200
GET
/tasks/{task_id}
Get a task
get_task 2 params → 200
PUT
/tasks/{task_id}
Update a tasks
update_a_task 2 params body → 200
DELETE
/tasks/{task_id}
Delete a tasks
delete_task 2 params → 200
POST
/tasks/{task_id}/percentage
Update completed percentage
update_percentage_task 2 params body → 200
POST
/tasks/{task_id}/markasopen
Mark task as open
mark_task_as_open 2 params → 200
POST
/tasks/{task_id}/markasongoing
Mark task as ongoing
mark_task_as_ongoing 2 params → 200
POST
/tasks/{task_id}/markascompleted
Mark task as completed
mark_task_as_completed 2 params → 200
POST
/tasks/{task_id}/comments
Add comment to task
add_task_comment 2 params body → 201
GET
/tasks/{task_id}/comments
List comments of task
list_task_comments 2 params → 200
DELETE
/tasks/{task_id}/comments/{comment_id}
Delete comment of task
delete_task_comment 3 params → 200
POST
/tasks/{task_id}/attachment
Add attachment to task
add_task_attachment 3 params → 201
GET
/tasks/{task_id}/documents/{document_id}
Get document of task
get_task_document 6 params → 200
DELETE
/tasks/{task_id}/documents/{document_id}
Delete document of task
delete_task_document 4 params → 200

Schemas 107

The contract defines 107 schemas that model the data the API accepts and returns. The most detailed are add-a-task-request (38 properties), update-a-task-request (38 properties), comment (11 properties), reminder (7 properties). Each schema is shown below with its type and property counts.

mail_id
string
Email ID to which the notification has to be sent.
update-a-task-response
object
3 properties
email_account_type
string
Email account type to which the notification has to be sent.
delete-a-task-response
object
2 properties
task_number
string
Unique number assigned to the task.
reminder
object
Details of the reminder set for the task.
7 properties
statuses
array
List of statuses for the task.
delete-tasks-response
object
2 properties
created_time
string
Creation time of the task.
delete-task-document-response
object
2 properties
commented_by_id
string
ID of the user who commented on the task.
client_name
string
Name of the client associated with the task.
task_type
string
Type of the task.
add-a-task-response
object
3 properties
entity_tags
array
List of tags associated with the task.
due_date
string
Due date of the task.
contact_name
string
Name of the contact associated with the task.
add-task-comment-request
object
1 property 1 required
email_account_id
string
Email account ID to which the notification has to be sent.
comments
array
List of comments for the task.
task_id
string
ID of the task.
list-tasks-response
object
3 properties
file_size_formatted
string
Formatted size of the file attached to the task.
parent_task_number
string
Number of the parent task.
client_id
string
ID of the client associated with the task.
document_id
string
ID of the document attached to the task.
transaction_type
string
Type of transaction associated with the task.
file_size
integer
Size of the file attached to the task in bytes.
task_number_suffix
string
Suffix of the task number.
custom_fields
array
List of custom fields associated with the task
file_type
string
Type of the file attached to the task.
custom_status_id
string
ID of the custom status of the task.
owners
array
List of owners of the task.
get-a-task-document-response
object
3 properties
comment_type
string
Type of the comment.
email_folder_id
string
Folder ID of the email account to which the notification has to be sent.
parent_status
string
Parent status of the task.
task_description
string
Description of the task.
template_id
string
ID of the template used for the task.
mail_attachments
array
List of attachments to be sent along with the email notification.
add-task-comment-response
object
3 properties
related_entity_id
string
ID of the related entity associated with the task.
contact_id
string
ID of the contact associated with the task.
parent_id
string
ID of the parent task.
update-a-task-request
object
38 properties
color_code
string
Color code of the task.
document
object
Details of the document attached to the task.
7 properties
documents
array
List of files attached to a particular task.
is_overdue
boolean
Indicates whether the task is overdue.
status
string
Status of the task.
owner_name
string
Name of the owner of the task.
priority
string
Priority of the task. Allowed values are normal , low , high , lowest and highest
completion_percentage
integer
Completion percentage of the task.
mark-ongoing-task-response
object
2 properties
created_by_name
string
Name of the user who created the task.
comment_id
string
ID of the comment on the task.
created_time_formatted
string
Formatted creation time of the task.
list-task-comments-response
object
3 properties
related_sub_entity_id
string
ID of the related sub entity associated with the task.
parent_task_id
string
ID of the parent task.
description
string
Description of the comment.
delete-task-comment-response
object
2 properties
attachment_order
integer
Order of the attachment in the task.
is_system_task
boolean
Indicates whether the task is a system task.
title
string
Title of the task.
get-a-task-response
object
3 properties
file_name
string
Name of the file attached to the task.
is_subtask
boolean
Indicates whether the task is a subtask.
task_rate
number
Rate of the task.
update-percentage-task-response
object
3 properties
dependencies
array
List of dependencies for the task.
can_show_in_portal
boolean
Indicates whether the document can be shown in the customer portal.
subtask_count
integer
Number of subtasks under the task.
comment
object
Comment on the task.
11 properties
owner_id
string
ID of the owner of the task.
time
string
Time when the comment was made.
billing_type
string
Billing type of the task.
date_description
string
Description of the date when the comment was made.
add-a-task-request
object
38 properties
send_email_notification
boolean
Indicates whether to send email notification for the task.
operation_type
string
Type of operation performed on the task.
related_entity
integer
Unique value assigned to each entity.
contact_type
string
Type of the contact associated with the task. Allowed values are customer and vendor
owner_ids
string
Comma separated list of owner IDs of the task.
last_modified_by_id
string
ID of the user who last modified the task.
is_billable
boolean
Indicates whether the task is billable.
update-percentage-task-request
object
1 property 1 required
transaction_id
string
ID of the transaction associated with the task.
mark-completed-task-response
object
2 properties
task_number_prefix
string
Prefix of the task number.
related_sub_entity_type
string
Type of the related sub entity associated with the task.
recurring_task_id
string
ID of the recurring task.
system_task_type
integer
Type of the system task.
add-task-attachment-response
object
3 properties
parent_task_name
string
Name of the parent task.
update-tasks-response
object
3 properties
related_entity_value
string
Value of the related entity associated with the task.
update-tasks-request
array
List of tasks to be updated.
mark-open-task-response
object
2 properties
related_entity_type
string
Type of the related entity associated with the task.
is_sub_task
boolean
Indicates whether the task is a sub task.
due_after
integer
Number of days after which the task is due.
commented_by
string
Name of the user who commented on the task.
can_push
boolean
Indicates if the task can be sync to client
is_accountant_task
boolean
Indicates whether the task is an accountant task.
created_by_id
string
ID of the user who created the task.
due_date_formatted
string
Formatted due date of the task.

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

zoho-inventory-tasks-api-openapi.yml Raw ↑

Other APIs Zoho Inventory publishes across the network.

Zoho Inventory Batches API
Zoho Inventory Bills API
Zoho Inventory Compositeitems API
Zoho Inventory Contact Persons API
Zoho Inventory Contacts API
Zoho Inventory Credit Notes API
Zoho Inventory Currency API
Zoho Inventory Customer Payments API
Zoho Inventory Delivery Challans API
Zoho Inventory Inventoryadjustments API
Zoho Inventory Invoices API
Zoho Inventory Items API
Where this information came from

This is an independent, third-party profile of Zoho Inventory Tasks API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.