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), document (7 properties). Each schema is shown below with its type and property counts.

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