{"openapi":"3.0.0","info":{"title":"Tasks","description":"The Zoom Tasks APIs let you manage and automate tasks within the Zoom ecosystem. Create, view, update, and delete tasks that help teams stay organized across meetings and projects. The Zoom Tasks REST API lets developers programmatically integrate task management into their workflows, enabling seamless coordination and productivity directly through Zoom.","termsOfService":"https://zoom.us/docs/en-us/zoom_api_license_and_tou.html","contact":{"name":"Zoom Developers","url":"https://developer.zoom.us/"},"version":"2"},"externalDocs":{"description":"Find out more about Swagger","url":"https://swagger.io"},"servers":[{"url":"https://api.zoom.us/v2"}],"paths":{"/tasks/items/{taskId}/assignees":{"get":{"tags":["Assignee"],"summary":"Get assignees of a task","description":"Retrieves the list of assignees of a specified task.\n\n**[Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `tasks_assignee:read:admin`,`tasks_assignee:read`\n\n**[Granular Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `tasks:read:assignees`,`tasks:read:assignees:admin`\n\n**[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `LIGHT`","operationId":"GetAssigneesOfATask","parameters":[{"name":"taskId","in":"path","description":"The unique identifier of the task.","required":true,"schema":{"type":"string","example":"z2vo9qNRRHKArlJqkVHNUw"}}],"responses":{"200":{"description":"Assignees retrieved successfully.","content":{"application/json":{"schema":{"type":"object","properties":{"task_id":{"type":"string","description":"The unique ID of the task.","example":"z2vo9qNRRHKArlJqkVHNUw"},"assignees":{"type":"array","description":"A list of all assignees associated with the task. ","items":{"required":["display_name","user_id"],"type":"object","properties":{"user_id":{"type":"string","description":"The Zoom user ID of the task assignee.","example":"CcrEGgmeQem1uyJsuIRKwA"},"display_name":{"type":"string","description":"The display name of the assignee.","example":"John Doe"},"email":{"type":"string","description":"The email address of the assignee.","format":"email","example":"john.doe@example.com"},"avatar":{"type":"string","description":"The assignee's avatar image URL.","format":"uri","example":"https://example.com/avatar.jpg"}}}}}}}}},"403":{"description":"**HTTP Status Code:** `403` <br>\n Forbidden  \n\n **Error Code:** `111800` <br>\n You don't have permission to request the task <br>\n"},"404":{"description":"**HTTP Status Code:** `404` <br>\n Not Found  \n\n **Error Code:** `112100` <br>\n The resource not found. <br>\n"},"429":{"description":"**HTTP Status Code:** `429` <br>\n Too Many Requests. For more information, see [rate limits](https://developers.zoom.us/docs/api/rate-limits/). \n\n "}},"security":[{"openapi_oauth":["tasks_assignee:read:admin","tasks_assignee:read","tasks:read:assignees","tasks:read:assignees:admin"],"openapi_authorization":[]}],"x-extensions":{"x-permissions":["TasksMgt:Read"],"x-macro-scopes":["tasks_assignee:read:admin","tasks_assignee:read"],"x-granular-scopes":["tasks:read:assignees","tasks:read:assignees:admin"]}},"post":{"tags":["Assignee"],"summary":"Add assignees to a task","description":"Add one or more assignees to a specified task. If a user is an assignee, they are also considered a collaborator.\n\n**[Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `tasks_assignee:write`,`tasks_assignee:write:admin`\n\n**[Granular Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `tasks:write:assignees`,`tasks:write:assignees:admin`\n\n**[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `LIGHT`","operationId":"addTasksAssignees","parameters":[{"name":"taskId","in":"path","description":"The task's unique identifier.","required":true,"schema":{"type":"string","example":"z2vo9qNRRHKArlJqkVHNUw"}}],"requestBody":{"description":"Request body containing the assignees to add, along with optional invitation details.","content":{"application/json":{"schema":{"required":["assignees"],"type":"object","properties":{"invite_message":{"maxLength":200,"type":"string","description":"An optional message to include with the assignee invitation.","example":"Please help with this task."},"skip_notifications":{"type":"boolean","description":"Whether to skip sending notifications to the added assignees. By default, notifications are sent.","example":false,"default":false},"assignees":{"maxItems":20,"minItems":1,"type":"array","description":"The email address of the assignee to add. The user must belong to the same account as the requesting user.","items":{"required":["email"],"type":"object","properties":{"email":{"type":"string","description":"The email address of the assignee to invite.","format":"email","example":"user@example.com"}}}}}}}}},"responses":{"201":{"description":"Assignees added successfully.","content":{"application/json":{"schema":{"required":["assignees","task_id"],"type":"object","properties":{"task_id":{"type":"string","description":"The task's unique ID.","example":"z2vo9qNRRHKArlJqkVHNUw"},"assignees":{"maxItems":20,"minItems":0,"type":"array","description":"A list of all assignees associated with the task. ","items":{"required":["display_name","user_id"],"type":"object","properties":{"user_id":{"type":"string","description":"The assignee's Zoom user ID.","example":"CcrEGgmeQem1uyJsuIRKwA"},"display_name":{"type":"string","description":"The assignee's Zdisplay name.","example":"John Doe"},"email":{"type":"string","description":"The assignee's Zemail address.","format":"email","example":"john.doe@example.com"},"avatar":{"type":"string","description":"The assignee's Zavatar image URL.","format":"uri","example":"https://example.com/avatar.jpg"}}}}}}}}},"400":{"description":"**HTTP Status Code:** `400` <br>\n Bad Request  \n\n **Error Code:** `34002` <br>\n Invalid email {email}.  <br>\n"},"403":{"description":"**HTTP Status Code:** `403` <br>\n Forbidden  \n\n **Error Code:** `111800` <br>\n You are no permission to request the task. <br>\n"},"404":{"description":"**HTTP Status Code:** `404` <br>\n Not Found  \n\n **Error Code:** `112100` <br>\n The resource not found. <br>\n"},"429":{"description":"**HTTP Status Code:** `429` <br>\n Too Many Requests. For more information, see [rate limits](https://developers.zoom.us/docs/api/rate-limits/). \n\n "}},"security":[{"openapi_oauth":["tasks_assignee:write","tasks_assignee:write:admin","tasks:write:assignees","tasks:write:assignees:admin"],"openapi_authorization":[]}],"x-extensions":{"x-permissions":["TasksMgt:Edit"],"x-macro-scopes":["tasks_assignee:write","tasks_assignee:write:admin"],"x-granular-scopes":["tasks:write:assignees","tasks:write:assignees:admin"]}}},"/tasks/items/{taskId}/assignees/{userId}":{"delete":{"tags":["Assignee"],"summary":"Remove Assignee from task","description":"Removes a specific assignee from a task. \n\n**[Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `tasks_assignee:write`,`tasks_assignee:write:admin`\n\n**[Granular Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `tasks:delete:assignees`,`tasks:delete:assignees:admin`\n\n**[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `LIGHT`","operationId":"removeTaskAssignee","parameters":[{"name":"taskId","in":"path","description":"The unique identifier of the task.","required":true,"schema":{"type":"string","example":"z2vo9qNRRHKArlJqkVHNUw"}},{"name":"userId","in":"path","description":"The Zoom user ID of the task assignee.","required":true,"schema":{"type":"string","example":"CcrEGgmeQem1uyJsuIRKwA"}}],"responses":{"204":{"description":"Collaborator removed successfully"},"403":{"description":"**HTTP Status Code:** `403` <br>\n Forbidden  \n\n **Error Code:** `111800` <br>\n You do not have permission to operate on the task. <br>\n"},"404":{"description":"**HTTP Status Code:** `404` <br>\n Not Found  \n\n **Error Code:** `112100` <br>\n The task not found. <br>\n**Error Code:** `112100` <br>\n The assignee not found. <br>\n"},"429":{"description":"**HTTP Status Code:** `429` <br>\n Too Many Requests. For more information, see [rate limits](https://developers.zoom.us/docs/api/rate-limits/). \n\n "}},"security":[{"openapi_oauth":["tasks_assignee:write","tasks_assignee:write:admin","tasks:delete:assignees","tasks:delete:assignees:admin"],"openapi_authorization":[]}],"x-extensions":{"x-permissions":["TasksMgt:Edit"],"x-macro-scopes":["tasks_assignee:write","tasks_assignee:write:admin"],"x-granular-scopes":["tasks:delete:assignees","tasks:delete:assignees:admin"]}}},"/tasks/items/{taskId}/collaborators":{"get":{"tags":["Collaborator"],"summary":"Get collaborators of a task","description":"Retrieves all collaborators of a specified task.\n\n**[Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `tasks_collaborator:read:admin`,`tasks_collaborator:read`\n\n**[Granular Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `tasks:read:list_collaborators`,`tasks:read:list_collaborators:admin`\n\n**[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `LIGHT`","operationId":"Getcollaboratorsofatask","parameters":[{"name":"taskId","in":"path","description":"The unique ID of the task.","required":true,"schema":{"type":"string","example":"z2vo9qNRRHKArlJqkVHNUw"}}],"responses":{"200":{"description":"Collaborators retrieved successfully.","content":{"application/json":{"schema":{"type":"object","properties":{"task_id":{"type":"string","description":"The unique ID of the task.","example":"z2vo9qNRRHKArlJqkVHNUw"},"collaborators":{"type":"array","description":"A list of all collaborators associated with the task.","items":{"required":["display_name","user_id"],"type":"object","properties":{"user_id":{"type":"string","description":"The Zoom user ID of the collaborator.","example":"CcrEGgmeQem1uyJsuIRKwA"},"display_name":{"type":"string","description":"The display name of the collaborator.","example":"John Doe"},"email":{"type":"string","description":"The email address of the collaborator.","format":"email","example":"john.doe@example.com"},"avatar":{"type":"string","description":"The avatar image URL of the collaborator.","format":"uri","example":"https://example.com/avatar.jpg"}}}}}}}}},"403":{"description":"**HTTP Status Code:** `403` <br>\n Forbidden  \n\n **Error Code:** `111800` <br>\n You don't have permission to request the task. <br>\n"},"404":{"description":"**HTTP Status Code:** `404` <br>\n Not Found  \n\n **Error Code:** `112100` <br>\n The resource not found. <br>\n"},"429":{"description":"**HTTP Status Code:** `429` <br>\n Too Many Requests. For more information, see [rate limits](https://developers.zoom.us/docs/api/rate-limits/). \n\n "}},"security":[{"openapi_oauth":["tasks_collaborator:read:admin","tasks_collaborator:read","tasks:read:list_collaborators","tasks:read:list_collaborators:admin"],"openapi_authorization":[]}],"x-extensions":{"x-permissions":["TasksMgt:Read"],"x-macro-scopes":["tasks_collaborator:read:admin","tasks_collaborator:read"],"x-granular-scopes":["tasks:read:list_collaborators","tasks:read:list_collaborators:admin"]}},"post":{"tags":["Collaborator"],"summary":"Add collaborators to a task","description":"Add one or more collaborators to a specified task.\n\n**[Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `tasks_collaborator:write`,`tasks_collaborator:write:admin`\n\n**[Granular Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `tasks:write:collaborators`,`tasks:write:collaborators:admin`\n\n**[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `LIGHT`","operationId":"addTasksCollaborators","parameters":[{"name":"taskId","in":"path","description":"The task's unique identifier.","required":true,"schema":{"type":"string","example":"z2vo9qNRRHKArlJqkVHNUw"}}],"requestBody":{"description":"Request body containing the collaborators to add, along with optional invitation details.","content":{"application/json":{"schema":{"required":["collaborators"],"type":"object","properties":{"invite_message":{"maxLength":200,"type":"string","description":"An optional message to include with the collaborator invitation.","example":"Please help with this task."},"skip_notifications":{"type":"boolean","description":"Whether to skip sending notifications to the added collaborators.\n By default, notifications are sent.","example":false},"collaborators":{"maxItems":20,"minItems":1,"type":"array","description":"A list of collaborators to add to the task. The user must belong to the same account as the requesting user.","items":{"required":["email"],"type":"object","properties":{"email":{"type":"string","description":"The email address of the collaborator to invite.","format":"email","example":"jchill@example.com"}}}}}}}}},"responses":{"201":{"description":"Collaborators added successfully.","content":{"application/json":{"schema":{"required":["collaborators","task_id"],"type":"object","properties":{"task_id":{"type":"string","description":"The task's unique ID.","example":"z2vo9qNRRHKArlJqkVHNUw"},"collaborators":{"maxItems":20,"minItems":0,"type":"array","description":"A list of all collaborators associated with the task.","items":{"required":["display_name","user_id"],"type":"object","properties":{"user_id":{"type":"string","description":"The collaborator's Zoom user ID.","example":"CcrEGgmeQem1uyJsuIRKwA"},"display_name":{"type":"string","description":"The collaborator's display name.","example":"John Doe"},"email":{"type":"string","description":"The collaborator's email address.","format":"email","example":"john.doe@example.com"},"avatar":{"type":"string","description":"The collaborator's avatar image URL.","format":"uri","example":"https://example.com/avatar.jpg"}}}}}}}}},"400":{"description":"**HTTP Status Code:** `400` <br>\n Bad Request  \n\n **Error Code:** `34002` <br>\n Invalid email {email}.  <br>\n"},"403":{"description":"**HTTP Status Code:** `403` <br>\n Forbidden  \n\n **Error Code:** `111800` <br>\n You are no permission to request the task. <br>\n"},"404":{"description":"**HTTP Status Code:** `404` <br>\n Not Found  \n\n **Error Code:** `112100` <br>\n The resource not found. <br>\n"},"429":{"description":"**HTTP Status Code:** `429` <br>\n Too Many Requests. For more information, see [rate limits](https://developers.zoom.us/docs/api/rate-limits/). \n\n "}},"security":[{"openapi_oauth":["tasks_collaborator:write","tasks_collaborator:write:admin","tasks:write:collaborators","tasks:write:collaborators:admin"],"openapi_authorization":[]}],"x-extensions":{"x-permissions":["TasksMgt:Edit"],"x-macro-scopes":["tasks_collaborator:write","tasks_collaborator:write:admin"],"x-granular-scopes":["tasks:write:collaborators","tasks:write:collaborators:admin"]}}},"/tasks/items/{taskId}/collaborators/{userId}":{"delete":{"tags":["Collaborator"],"summary":"Remove collaborator from task","description":"Removes a specific collaborator from a task. This operation will completely remove the user's access to the task.\n\n**[Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `tasks_collaborator:write`,`tasks_collaborator:write:admin`\n\n**[Granular Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `tasks:delete:collaborator:admin`,`tasks:delete:collaborator`\n\n**[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `LIGHT`","operationId":"removeTaskCollaborator","parameters":[{"name":"taskId","in":"path","description":"The unique ID of the task.","required":true,"schema":{"type":"string","example":"z2vo9qNRRHKArlJqkVHNUw"}},{"name":"userId","in":"path","description":"Zoom user ID of the collaborator.","required":true,"schema":{"type":"string","example":"CcrEGgmeQem1uyJsuIRKwA"}}],"responses":{"204":{"description":"Collaborator removed successfully"},"403":{"description":"**HTTP Status Code:** `403` <br>\n Forbidden  \n\n **Error Code:** `111800` <br>\n You do not have permission to operate on the task. <br>\n"},"404":{"description":"**HTTP Status Code:** `404` <br>\n Not Found  \n\n **Error Code:** `112100` <br>\n The task not found. <br>\n**Error Code:** `112100` <br>\n The assignee not found. <br>\n"},"429":{"description":"**HTTP Status Code:** `429` <br>\n Too Many Requests. For more information, see [rate limits](https://developers.zoom.us/docs/api/rate-limits/). \n\n "}},"security":[{"openapi_oauth":["tasks_collaborator:write","tasks_collaborator:write:admin","tasks:delete:collaborator:admin","tasks:delete:collaborator"],"openapi_authorization":[]}],"x-extensions":{"x-permissions":["TasksMgt:Edit"],"x-macro-scopes":["tasks_collaborator:write","tasks_collaborator:write:admin"],"x-granular-scopes":["tasks:delete:collaborator:admin","tasks:delete:collaborator"]}}},"/tasks/items/{taskId}/comments":{"get":{"tags":["Comment"],"summary":"Get a task's comments","description":"Retrieves all comments associated with a specific task.\n\n**[Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `tasks_comment:read`,`tasks_comment:read:admin`\n\n**[Granular Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `tasks:read:comments`,`tasks:read:comments:admin`\n\n**[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `LIGHT`","operationId":"GetAV1TasksComment","parameters":[{"name":"taskId","in":"path","description":"The unique identifier of the task.","required":true,"schema":{"type":"string","example":"z2vo9qNRRHKArlJqkVHNUw"}},{"name":"page_size","in":"query","description":"The number of records returned from a single API call.","required":false,"schema":{"maximum":50,"type":"integer","example":10,"default":10}},{"name":"next_page_token","in":"query","description":"The next page token used to paginate through large result sets. A next page token will be returned whenever the set of available results exceeds the current page size. The expiration period for this token is 15 minutes.","required":false,"schema":{"type":"string","example":"R4aF9Oj0fVM2hhezJTEmSKaBSkfesDwGy42"}}],"responses":{"200":{"description":"Task comments retrieved successfully.","content":{"application/json":{"schema":{"type":"object","properties":{"comments":{"type":"array","description":"The list of comments associated with the task.","items":{"type":"object","properties":{"comment_id":{"type":"string","description":"The unique identifier of the comment.","example":"comment_abc123def456"},"content":{"type":"array","description":"The array of content fragments that make up the comment. Each fragment must define its order and contain either plain text or a mention. Fragments may also include attributes such as a hyperlink.","items":{"required":["order"],"type":"object","properties":{"text":{"type":"string","description":"The plain text fragment. May include letters, numbers, symbols, or emoji. Required if no `mention` is provided. If combined with `attributes.link`, this text is rendered as a hyperlink.","example":"the text demo"},"order":{"type":"number","description":"The position of the fragment within the comment. Must be unique within the `content` array. Defines the sequence for rendering.","example":0},"attributes":{"type":"object","properties":{"link":{"type":"string","description":"The URL associated with the fragment's text. Typically an absolute `http://` or `https://` link.","example":"https://google.cn"}},"description":"Optional metadata for the fragment. Currently supports only hyperlinks."},"mention":{"type":"object","properties":{"email":{"type":"string","description":"The email address of the user being mentioned.","example":"example@zoom.us"},"user_id":{"type":"string","description":"The user ID of the user being mentioned.","example":"3afwV0HiZS9mCLpxSQQbVz"},"display_name":{"type":"string","description":"The display name of the user.","example":"John Doe"},"avatar":{"type":"string","description":"The avatar image URL of the user.","format":"uri","example":"https://example.com/avatar.jpg"}},"description":"Represents a mention of an entity (e.g., a user). If present, the fragment represents a mention instead of plain text."}}}},"content_text":{"type":"string","description":"A plain text version of the entire comment content.","example":"the text demo"},"create_time":{"type":"integer","description":"Creation timestamp in milliseconds.","format":"int64","example":1752715586000}},"description":"A comment is represented as an ordered array of fragments. Each fragment may contain plain text, a mention, or a text snippet with a hyperlink."}},"next_page_token":{"type":"string","description":"Use the next page token to paginate through a large set of results. A next page token is returned when the available results exceed the current page size. This token's expiration period is 15 minutes.","example":"qUEQqB1V0HVhJmwKFQrGOD"},"page_size":{"type":"integer","description":"The number of records returned per page in a single API call.","example":10},"total_records":{"type":"integer","description":"The total number of records found.","example":2}}}}}},"403":{"description":"**HTTP Status Code:** `403` <br>\n Forbidden  \n\n **Error Code:** `111800` <br>\n You don't have permission to operate on the task. <br>\n"},"404":{"description":"**HTTP Status Code:** `404` <br>\n Not Found  \n\n **Error Code:** `112100` <br>\n The task not found. <br>\n"},"429":{"description":"**HTTP Status Code:** `429` <br>\n Too Many Requests. For more information, see [rate limits](https://developers.zoom.us/docs/api/rate-limits/). \n\n "}},"security":[{"openapi_oauth":["tasks_comment:read","tasks_comment:read:admin","tasks:read:comments","tasks:read:comments:admin"],"openapi_authorization":[]}],"x-extensions":{"x-permissions":["TasksMgt:Read","TasksContent:Read"],"x-macro-scopes":["tasks_comment:read","tasks_comment:read:admin"],"x-granular-scopes":["tasks:read:comments","tasks:read:comments:admin"]}},"post":{"tags":["Comment"],"summary":"Add a comment to a task","description":"Adds a comment to a specific task.\n\n**[Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `tasks_comment:write`,`tasks_comment:write:admin`\n\n**[Granular Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `tasks:write:comment:admin`,`tasks:write:comment`\n\n**[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `LIGHT`","operationId":"addComment","parameters":[{"name":"taskId","in":"path","description":"The unique identifier of the task.","required":true,"schema":{"type":"string","example":"z2vo9qNRRHKArlJqkVHNUw"}}],"requestBody":{"content":{"application/json":{"schema":{"required":["content","content_text"],"type":"object","properties":{"content":{"maxItems":100,"minItems":1,"type":"array","description":"The array of content fragments that make up the comment. Each fragment must define its order and contain either plain text or a mention. Fragments may also include attributes such as hyperlinks.","items":{"required":["order"],"type":"object","properties":{"text":{"type":"string","description":"A plain text fragment that may include letters, numbers, symbols, or emoji. Required if no mention is provided. If combined with attributes.link, this text is rendered as a hyperlink.","example":"the text demo"},"order":{"type":"number","description":"The position of the fragment within the comment.\nMust be unique within the `content` array.\nDefines the sequence for rendering.","example":0},"attributes":{"type":"object","properties":{"link":{"type":"string","description":"The URL associated with the fragment's text, typically an absolute http:// or https:// link.","example":"https://google.cn"}},"description":"Optional metadata for the fragment. Currently supports only hyperlinks."},"mention":{"type":"object","properties":{"email":{"type":"string","description":"The email address of the user being mentioned.","format":"email","example":"example@zoom.us"},"user_id":{"type":"string","description":"The user ID of the user being mentioned.","example":"3afwV0HiZS9mCLpxSQQbV"}},"description":"Represents a user mention. Provide either the email or the user ID. If present, the fragment will be treated as a mention instead of plain text."}}}},"content_text":{"maxLength":2000,"minLength":1,"type":"string","description":"A plain text version of the entire comment content.","example":"the text demo"}},"description":"Request body for adding a comment. A comment is represented as an ordered array of fragments. Each fragment may contain plain text, a mention, or a text snippet with a hyperlink."}}}},"responses":{"201":{"description":"Comment added successfully","content":{"application/json":{"schema":{"required":["comment_id","content"],"type":"object","properties":{"comment_id":{"type":"string","description":"The unique identifier of the created comment.","example":"comment_abc123def456"},"content":{"maxItems":100,"minItems":0,"type":"array","description":"The array of content fragments that make up the comment.\nEach fragment must define its order and contain either plain text or a mention.\nFragments may also include attributes such as a hyperlink.","items":{"required":["order"],"type":"object","properties":{"text":{"type":"string","description":"A plain text fragment that may include letters, numbers, symbols, or emoji. Required if no mention is provided. If combined with attributes.link, this text is rendered as a hyperlink.","example":"the text demo"},"order":{"type":"number","description":"The position of the fragment within the comment.\nMust be unique within the `content` array.\nDefines the sequence for rendering.","example":0},"attributes":{"type":"object","properties":{"link":{"type":"string","description":"The URL associated with the fragment's text, typically an absolute http:// or https:// link.","example":"https://google.cn"}},"description":"Optional metadata for the fragment. Currently supports only hyperlinks."},"mention":{"type":"object","properties":{"email":{"type":"string","description":"The email address of the user being mentioned.","example":"example@zoom.us"},"user_id":{"type":"string","description":"The user ID of the user being mentioned.","example":"3afwV0HiZS9mCLpxSQQbV"},"display_name":{"type":"string","description":"The display name of the user.","example":"John Doe"},"avatar":{"type":"string","description":"The avatar image URL of the user.","format":"uri","example":"https://example.com/avatar.jpg"}},"description":"Represents a mention of an entity (e.g., a user). If present, the fragment represents a mention instead of plain text."}}}},"content_text":{"type":"string","description":"A plain text version of the entire comment content.","example":"the text demo"},"create_time":{"type":"integer","description":"Creation timestamp in milliseconds.","format":"int64","example":1752715586000}}}}}},"400":{"description":"**HTTP Status Code:** `400` <br>\n Bad Request  \n\n **Error Code:** `34002` <br>\n Invalid request body. Please verify the content and try again. <br>\n"},"403":{"description":"**HTTP Status Code:** `403` <br>\n Forbidden  \n\n **Error Code:** `111800` <br>\n You don't have permission to request the task. <br>\n"},"404":{"description":"**HTTP Status Code:** `404` <br>\n Not Found  \n\n **Error Code:** `112100` <br>\n The resource not found. <br>\n"},"429":{"description":"**HTTP Status Code:** `429` <br>\n Too Many Requests. For more information, see [rate limits](https://developers.zoom.us/docs/api/rate-limits/). \n\n "}},"security":[{"openapi_oauth":["tasks_comment:write","tasks_comment:write:admin","tasks:write:comment:admin","tasks:write:comment"],"openapi_authorization":[]}],"x-extensions":{"x-permissions":["TasksMgt:Edit"],"x-macro-scopes":["tasks_comment:write","tasks_comment:write:admin"],"x-granular-scopes":["tasks:write:comment:admin","tasks:write:comment"]}}},"/tasks/items/{taskId}/comments/{commentId}":{"delete":{"tags":["Comment"],"summary":"Delete a task's comment","description":"Deletes a specific comment from a task by its ID.\n\n**[Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `tasks_comment:write`,`tasks_comment:write:admin`\n\n**[Granular Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `tasks:delete:comment:admin`,`tasks:delete:comment`\n\n**[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `LIGHT`","operationId":"DeleteTaskComment","parameters":[{"name":"taskId","in":"path","description":"The unique identifier of the task.","required":true,"schema":{"type":"string","example":"z2vo9qNRRHKArlJqkVHNUw"}},{"name":"commentId","in":"path","description":"The unique identifier of the comment to delete.","required":true,"schema":{"type":"string","example":"c1vo9qNRRHKArlJqkVHNUx"}}],"responses":{"204":{"description":"Comment deleted successfully. No content is returned."},"403":{"description":"**HTTP Status Code:** `403` <br>\n Forbidden  \n\n **Error Code:** `111800` <br>\n You don't have permission to operate on the task. <br>\n"},"404":{"description":"**HTTP Status Code:** `404` <br>\n Not Found  \n\n **Error Code:** `112100` <br>\n The task not found. <br>\n**Error Code:** `112100` <br>\n The comment not found. <br>\n"},"429":{"description":"**HTTP Status Code:** `429` <br>\n Too Many Requests. For more information, see [rate limits](https://developers.zoom.us/docs/api/rate-limits/). \n\n "}},"security":[{"openapi_oauth":["tasks_comment:write","tasks_comment:write:admin","tasks:delete:comment:admin","tasks:delete:comment"],"openapi_authorization":[]}],"x-extensions":{"x-permissions":["TasksMgt:Edit"],"x-macro-scopes":["tasks_comment:write","tasks_comment:write:admin"],"x-granular-scopes":["tasks:delete:comment:admin","tasks:delete:comment"]}}},"/tasks/files":{"post":{"tags":["File"],"summary":"Upload a file in tasks ","description":"Uploads a file to tasks.\n**Notes**\n- Base URL - `https://fileapi.zoom.us/v2`.\n- Rate limit: 20 requests per second per user or 2000 requests per second per IP address.\n- The caller must support HTTP 30x redirects.\n- The caller must retain the Authorization header when redirected to a different hostname.\n- **Supported file formats** `.json`.\n- For an account-level [OAuth](/docs/integrations/create/) app, this API can only be used on behalf of a user who is assigned a [role](https://support.zoom.com/hc/en/article?id=zm_kb&sysparm_article=KB0064983#h_80abad9b-86a8-492c-8a3b-5b0141a8c0a9) with **Edit** permission for Tasks Management.\n\n**[Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `tasks_file:write`,`tasks_file:write:admin`\n\n**[Granular Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `tasks:write:file`,`tasks:write:file:admin`\n\n**[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `HEAVY`\n\n**Not supported in Gov cluster** ","operationId":"Uploadfilefortasksimport","requestBody":{"content":{"multipart/form-data":{"schema":{"required":["file"],"type":"object","properties":{"file":{"type":"string","description":"The upload file in binary format. The maximum file size is 10 MB.","format":"binary","example":"Vm0wd2QyUXlVWGxWV0d4V1YwZDRWMVl3WkRSV01WbDNXa1JTVjAxV2JETlhhMUpUVmpBeFYySkVUbGhoTVVwVVZtcEJlRll5U2tWVWJHaG9UVlZ3VlZadGNFSmxSbGw1VTJ0V1ZXSkhhRzlVVmxaM1ZsWmFkR05GU214U2JHdzFWVEowVjFaWFNraGhSemxWVm14YU0xWnNXbUZrUjA1R1UyMTRVMkpIZHpGV1ZFb3dWakZhV0ZOcmFHaFNlbXhXVm0xNFlVMHhXbk5YYlVaclVqQTFSMVV5TVRSVk1rcElaSHBHVjFaRmIzZFdha1poVjBaT2NtRkhhRk5sYlhoWFZtMHhORmxWTUhoWGJrNVlZbFZhY2xWcVFURlNNVlY1VFZSU1ZrMXJjRWxhU0hCSFZqRmFSbUl6WkZkaGExcG9WakJhVDJOdFJraGhSazVzWWxob1dGWnRNSGhPUm14V1RVaG9XR0pyTlZsWmJGWmhZMVphZEdSSFJrNVNiRm93V2xWYVQxWlhTbFpqUldSYVRVWmFNMVpxU2t0V1ZrcFpXa1p3VjFKV2NIbFdWRUpoVkRKT2MyTkZhR3BTYkVwVVZteG9RMWRzV1hoWGJFNVRUV3hHTlZWdGRHdGhiRXAwVld4c1dtSkdXbWhaTW5oWFl6RldjbHBHWkdsU2JrSmFWMnhXWVZReFdsaFRiRnBZVmtWd1YxbHJXa3RUUmxweFUydGFiRlpzV2xwWGExcDNZa2RGZWxGcmJGaFhTRUpJVmtSS1UxWXhXblZWYldoVFlYcFdlbGRYZUc5aU1XUkhWMjVTVGxOSFVuTlZha0p6VGtaVmVXUkhkRmhTTUhCSlZsZDRjMWR0U2tkWGJXaGFUVlp3YUZwRlpGTlRSa3B5VGxaT2FWSnRPVE5XTW5oWFlqSkZlRmRZWkU1V1ZscFVXVlJHZDFZeGJISlhhM1JVVW14d2VGVnRNVWRWTWtwV1lrUmFXR0V4Y0hKWlZXUkdaVWRPU0U5V1pHaGhNSEJ2Vm10U1MxUXlVa2RUYmtwb1VqSm9WRmxZY0ZkbGJHUllaVWM1YVUxWFVraFdNalZUVkd4a1NGVnNXbFZXYkhCSVZGUkdVMVp0UmtoUFYyaHBVbGhDTmxkVVFtRmpNV1IwVTJ0a1dHSlhhR0ZVVmxwM1lVWndSbHBHVGxSU2EzQjVWR3hhVDJGV1NuUlBWRTVYVFc1b1dGbHFTa1psUm1SWldrVTFWMVpzY0ZWWFZsSkhaREZaZUdKSVNsaGhNMUpWVlcxNGQyVkdWblJOVldSV1RXdHdWMWxyVW1GWFIwVjRZMGhLV2xaWFVrZGFWV1JQVTBVNVYxcEhhR2hOU0VKMlZtMTBVMU14VVhsVmEyUlVZbXR3YjFWcVNtOVdSbXhaWTBaa2JHSkhVbGxhVldNMVlWVXhXRlZyYUZkTmFsWlVWa2Q0VDFOSFJrZFJiRnBwVmtWVmQxWnRjRWRWTVZwMFVtdG9VRlp0YUZSVVZXaERUbFphU0dWSFJtcE5WMUl3VlRKMGExZEhTbGhoUjBaVlZucFdkbFl3V25KbFJtUnlXa1prVjJFelFqWldhMlI2VFZaWmQwMVdXbWxsYTFwWVdXeG9RMVJHVW5KWGJFcHNVbTFTZWxsVldsTmhWa3AxVVd4d1YySllVbGhhUkVaYVpVZEtTVk5zYUdoTk1VcFdWbGN4TkdReVZrZFdibEpPVmxkU1YxUlhkSGRXTVd4eVZXMUdXRkl3VmpSWk1HaExWMnhhV0ZWclpHRldWMUpRVlRCVk5WWXhjRWhoUjJoT1UwVktNbFp0TVRCVk1VMTRWVmhzVm1FeVVsVlpiWFIzWWpGV2NWTnRPVmRTYlhoYVdUQmFhMkpIU2toVmJHeGhWbGROTVZsV1ZYaFhSbFp5WVVaa1RtRnNXbFZXYTJRMFlURk9SMVp1VGxoaVJscFlXV3RvUTFOV1drZFZhMlJXVFZad01GVnRkRzlWUmxsNVlVaENWbUpIYUVSVWJYaHJWbFpHZEZKdGNFNVdNVWwzVmxSS01HRXhaRWhUYkdob1VqQmFWbFp1Y0Zka2JGbDNWMjVLYkZKdFVubFhhMXByVmpKRmVsRnFXbGRoTWxJMlZGWmFhMUl4VG5OWGJYQlRWak5vV1ZkWGVHOVJNVkpIVlc1S1dHSkZjSE5WYlRGVFpXeHNWbGRzVG1oU1ZFWjZWVEkxYjFZeFdqWlJhbEpWWVRKU1NGVnFSbUZYVm5CSVlVWk9WMVpHV2xkV2JHTjRUa2RSZVZaclpGZGliRXBQVm14a1UxWXhVbGhrU0dSWFRWZDRlVlpYTVVkWFJrbDNWbXBTV2sxSGFFeFdNbmhoVjBaV2NscEhSbGRXTVVwUlZsUkNWazVXV1hoalJXaG9VakpvVDFVd1ZrdE5iRnAwVFZSQ1ZrMVZNVFJXVm1oelZtMUZlVlZzVmxwaVdGSXpXV3BHVjJOV1RuUlBWbVJUWWxob1lWZFVRbUZoTWtwSVUydG9WbUpIZUdoV2JHUk9UVlpzVjFaWWFGaFNiRnA1V1ZWYWExUnRSbk5YYkZaWFlUSlJNRlpFUms5VFJrcHlXa1pLYVZKdVFuZFdiWFJYVm0xUmVGZHVVbXBTVjFKWFZGWmFkMDFHVm5Sa1J6bFdVbXh3TUZsVldsTldWbHBZWVVWU1ZXSkdjR2hWTUdSWFUwWktkR05GTlZkTlZXd3pWbXhTUzAxSFJYaGFSV2hVWWtkb2IxVnFRbUZXYkZwMVkwWmthMkpHYkROV01qVkxZa1pLZEZWdWJGaGhNWEJ5Vm1wS1JtVnNSbkZYYkdSb1RXeEpNbFpHV21GaE1VbDRWRzVPV0dKWVFsUldhazV2VjFaa1dHVkhPVkpOVmtwSVZsYzFTMWRIU2taalNFNVdZbFJHVkZwWGVITldiR1J6Vkcxb1UxWkZXalpXVkVreFlqRlplRmRxV2xOV1JVcG9WV3RXWVdOc1ZuRlRhM1JVVm14S01GbFZXazloUjFaelYyeEdWMkV4Y0doWFZtUlNaVlphY2xwR1pGaFNNMmg1VmxkMFYxTXhaRWRWYkdSWVltMVNjMVp0TVRCTk1WbDVUbGQwV0ZKcmJETldiWEJUVjJzeFIxTnNRbGRoYTNCSVdUSjRhMk50VmtkYVIyaG9UVEJLVWxac1VrZGhNVTE0VTFob2FsSlhVbWhWYlhNeFYwWlpkMVpyZEU1aVJuQXdWRlpTUTFack1WWk5WRkpYVm0xb2VsWnNXbXRUUjFaSFYyeHdWMUpXYjNwWFYzQkhWakpPVjFWdVNsVmlSMUpVV1d4b2IxbFdaRlZSYlVab1RWZFNTRll5TlU5aGJFcDBaVWRHVlZaV2NGZFVWbHB6VmpGYVdXRkhjR2xXV0VKSFZteGtOR0V4VW5SU2JrNVlZa1phV0ZsVVNsSk5SbXhWVW1zNVUwMVdjREZXUjNodllWWktjMk5HYkZoV00xSjJWVlJHYTFZeFpISmhSM1JUVFVad1dWZFhlR0ZaVms1WFZtNVNhMUo2YkZkVmJYaHpUbFpzVm1GRlRsZGlWWEJKV1ZWV1UxWlhTbGxoU0VwWFlrWndTRnBGV2t0a1IwNUdUbFprVGxaWGQzcFdiWGhUVXpBeFNGSllhR0ZTVjJoVldXdGtiMkl4Vm5GUmJVWlhZa1p3TVZrd1dtdGhNa3BIWWtST1YwMXFWa3haYTFwTFpFWldkV0pHYUdoTldFSjVWbTF3UzFKdFZuTlNia1pZWWtkU2IxUlhlRXBOYkZwSFYyMUdXR0pXUmpOVVZscHJWMGRLV0dWSVRscFdSVm96VmpGYWExZEhWa2hQVmtwT1ZsUkZNRlpzWkRSaE1XeFhVMnhrYWxORk5WZFpiRkpIVmtaWmVXVkhkR3BpUm5CV1ZXMTRhMVJzV25WUmFscFlWa1ZLYUZacVJtdFNNV1JaWTBaYWFXRXpRbGxXYlhSWFdWZFdjMWR1UmxOaVIxSnhWRlprVTJWc2JGWmFTRTVYVFZad01WVlhlRWRXTWtWNFkwZG9XRlp0VWxOYVZscGhZMnh3UjFwR2FGTk5NbWcxVm14a01GWXhUWGhhUldSV1lrZFNXVmx0TVZOak1WcDBUVlJDVGsxV2JEVlViR1F3VjBaS2NtSkVUbGRpV0VKVVZqSnplRk5IUmtabFJtUk9ZbTFvYjFacVFtRldNazV6WTBWb1UySkhVbGhVVmxaM1ZXeGFjMXBJWkZSTlZURTBWVEZvYzFVeVJYbGhSemxXWWtaS1dGWXdXbk5rUjFKR1pFVTFhVkp1UVhkV1JscFRVVEZhY2sxV1drNVdSa3BZVm01d1YxWkdXbkZUYTFwc1ZteGFNVlZ0ZUdGaFZrbDRVbGhrVjJKVVJUQlpla3BPWlVkT1JtRkdRbGRpVmtwVlYxZDBWMlF4WkhOWGEyaHNVak5DVUZadGVITk9SbGw1VGxVNWFHSkZjRmxaVlZwelZqSkZlRlpZYUdGU00yaDZWbXBHWVZkWFJrZGhSazVwVW0wNU5GWXhVa05aVjBWNFZXNU9XRmRIZUc5VmExWjNWMFpTVjFkdVpHaFNiRmt5VlcxMGQySkdTbk5UYWtaWFlsaG9URmxXV2t0ak1rNUhZa1prVTJKRmNFbFdXSEJDVFZkTmVGcElTbWhTTTJoVVZGVmFkMkZHV25SalJXUlVUVlZzTkZaWE5VOVhSMHBXVjJ4a1ZtSllhRE5VVlZwaFYwVTFWbFJzWkU1aE0wSktWMVpXVjFVeFduSk5WbVJxVWpKb1lWUldXbmRWUm10NFYyeGthazFYVW5sVWJGcHJWR3hhV0dRemNGZGlXR2hVVlhwQmVGTkdTbGxoUjBaVFZqSm9WbGRYZEd0aU1rbDRWbTVHVW1KVldsaFphMXAzVFZacmQxZHRkR2hOYTNCSVdXdFNUMVl3TVhGV2EzaGFZVEZ3VEZwRldsZGtWMHBIWVVkb1RsZEZTalZXYlRGM1V6RktkRlp1VGxOaWExcFpXV3RrVTJJeFVsaGxSWEJPWWtad1NGWXlNVWRYUjBwWFVtcE9WVlpzY0hKV01HUkxWMGRXU1ZSc2NGZFNWbTk2Vm1wR1lXRXhaRWhXYTJoUVZtdHdUMVp0ZEhkVFZscHpXWHBHVkUxWFVrbFZNblJoWVd4T1JrNVdaRnBpUmtwSVZtdGFkMWRIVmtsVWJHUnBVakZLTmxaclkzaGlNVmw1VWxod1VsZEhhRmhXYlRGT1pVWnNjVkpzY0d4U2JWSmFXVEJrYjFaR1NsbFJiR3hYWWxoU1dGZFdaRmRqTVdSMVVteE9hVkl4U25oV1JscHJWVEpXYzJKR1dtRlRSVFZZVkZaYWQwMVdWbGhsUldSWFRXdFdORmt3Wkc5WFJscDBWV3hPWVZac2NHaFpNbmgzVWpGd1IyRkdUazVOYldjeFZtMTRhMDFHV1hoVVdHaGhVbGRTVjFsclpGTlhWbXgwVFZaT2FrMVdjREJVVmxKRFZHc3hWMkpFVmxWaVIxRjNWakJhUzJOdFNrVlViR1JwVjBWS1ZWWnFTbnBsUms1SVVtdGFiRkp0VWs5WmJURnZZakZhY1ZGdFJsZE5helY2V1RCV2IxVXlTa2hWYkdoVlZteGFNMVpYZUdGak1YQkpXa1pTVGxaVVJUQldWRVp2WXpGVmVWSlliR2hTZW14WFdXdGFTMWRHV1hkWGJrNXJVakZLUjFwRlZURmhWa3AxVVZoa1YxSnNjRlJWVkVaaFkyc3hWMWRyTlZkU2EzQlpWbTB3ZUdJeVZuTlhiazVZWWxoU1ZWVnFSbUZUUmxsNVpVaGtWMDFWY0ZoWmFrNTNWMFphYzFkdGFGZGhhM0JRVm1wR1UyUldWbk5SYkdScFZtdHdWbFl4WkRCV01sRjRXa2hPV0dFeWFITlZhazVEVlVaYWRHVklUazlTYkd3MVZHeFZOV0ZIU2taalJteGFWbFp3ZWxacVNrWmxSbHBaWVVkR1UwMHlhRFpXYlhCSFdWWmtXRkpyYUdwU01uaFlWakJXUzFOR1duUmxSM1JQVWpCV05GWlhOVTlYUm1SSVpVYzVWbUV4V2pOV01GcHpWMGRTUm1SSGNHbFNiR3Q1VmxjeE1FMUhSblJTYWxwWFlrZG9XVmxVUm5kaFJteFhWMnQwYWsxck5VaFphMXB2VmpBd2VXRkhPVmRXZWtJMFZsY3hWMUl4Y0VsV2JGcHBWMFZLVlZadGNFZFRNV1JIVjJ0a1dHSlZXbkpVVlZKSFUwWmFkRTVXVG1oTlZXOHlXV3RhYTFadFNsbGhSRTVWVmxad2VsWnRlR3RqTVZKeldrWmthVk5GU21GV01WcFhWakZWZUZkc2FGUmhNbEp4VldwS2IxWXhVbFphUms1WVVteFdNMVl5ZERCaE1VbDNUbFZrVldKR2NISldSM2hoVjBkUmVtTkdaR2xYUjJoVlZsaHdRbVZHVGtkVWJHeHBVbXMxYjFSWGVFdFdiR1JZVFZod1RsWnNjRmhaYTJoTFdWWktObUpHYUZwaE1YQXpXbGQ0V21WVk5WaGtSbFpvWld0YVdWZFVRbTlqTVZsM1RWaEdVMkV5YUdGV2FrNXZZVVpyZVdONlJsaFdNSEJJV1ZWa2IxUnNaRVpUYkVwWFRWWndhRmRXV2s1bFZsSjFWV3hXYUUxV2NGcFhWM1JyVlRKT1IxWnVSbEpXUlVwUFZXMHhVMWRzYTNkV2JYUlhUV3R3V0ZWdGNFOVdWbHB6VjI1d1dsWldjRXhaTW5NeFYwVTVWMk5IYUU1aVYyaEdWbTF3UjFsWFJYaFhXR2hxVWxaYVUxbHNhRk5qUmxwMFpFWndUbEpzY0hoVk1uQlRWakF4VjFacVZsWk5ibEp5V1ZkNFQxSnJOVmRhUm5CcFVtdHdTVlp0ZEdGVk1WbDRXa2hPV0dKWWFGaFVWVkpTWlZaYVdFMVVVbWxOVmxZMVZXeG9kMVZ0U2xaWGJHaFhZbFJHVDFwVlduTmpWa3B6WTBkNFUySldTbUZYVkVKcllqRmFSMU5zYkZKaVIxSlpWbTE0UzFSR1dsVlNhemxUVFZad01WVnRlRTloVmxwWFkwWndWMkpVUVhoVlZFWlBWakpLUjFkc2FHaGxiWGhaVmtaYVlXUXhUa2RYV0d4c1VqTlNXRlJYZEhkVFZscElZMFpPVjFZd1ZqVldWM2hQV1ZaYWMyTkhhRnBOYm1nelZXcEdkMUl5UmtkVWF6Vk9ZbGRqZUZadE1UUmhNbEY0VWxob2FWSnRhRlpaVkVwVFYwWnNkR1ZGZEdwTlZsWXpWMnRhVDJGck1WaGxTR3hYVFdwV1VGWkVSbUZrVmtaeldrWndWMVl4UmpOV2FrSmhVekpPZEZOclZsVmlSMUp3VmpCV1MxWldXbkZUYm5Cc1VtdHNORlpITlU5VmJVcElWV3M1V2xZelVtaFZNRnByWXpGa2RGSnNaRTVoZWxZMlYxUkNWMkl4VlhsVGEyaFdZWHBzVmxadWNFZGtiRlY1WlVad2JGSnNXbmxaTUdRMFZUSkdObEpVUWxkV1JWcDJXV3BLUjJNeFRuTmhSMmhVVWxWd1dGZFhlRk5TTWxKelYyNUtXR0pWV25GVVYzUmhVakZhU0dWR1RsVmlSbkF4VlZab2ExWXhTbk5qUmxKV1ZrVmFhRmt5YzNoV01XUnlUbFprVTJFelFscFdNV1F3WVRKSmVWVnVUbGhYUjFKWldXeG9VMVpXVm5GUmJVWlVVbTE0ZVZZeU5XdGhSbHAwVld0c1dsWlhUVEZXYWtwTFZsWktWVkZzY0d4aE0wSlJWMWh3UzFReFNuUlNhMlJTWWtkU1QxUlZWbmRXYkZsNFdrUkNhVTFWVmpOVWJGWnJWMGRLY21OSFJsVldSWEJVVmxWYVlXUkhWa2xVYXpsVFlrZDNNVlpIZUZaT1YwWklVMnRhYWxKdGVHRldiRnAzWld4YWNWTnJXbXhTYkhCYVdWVmtSMVV3TUhsaFJGcFhZbGhDU0ZkV1dtdFhSa3B5V2tkb1UyRjZWbmRXVnpBeFVXc3hWMWRZYUZoaVIxSmhWbXBDVjA1R1dsaE9WazVXVFd0d2VWUnNXbk5YYlVWNFkwZG9WMDFHY0hwV2JGcFBZekZPY2s1V1RtbFdhM0JhVm0xd1MwMUZNVWhTYmtwT1ZtMVNWVmxYZEdGWFJsWjFZMFZrYTJKR2NGWlZNblF3VlRBeGNrNVZhRnBoTVhCeVZsUktTMUp0VGtaTlZtaFhUVEJLU1ZaclVrZFhiVlpIWTBWc1ZHSlhhRlJVVkVwdlZsWmFSMVp0Um10TmExcElWakkxVTFSc1RraGhSbVJWVm14YWVsUnJXbUZYUlRWV1QxWm9VMDFJUWxoV2FrbzBZVEZhZEZOc2JHaFNSVFZXVm14YWQyVnNXblJsUjNScVRWWktlbGRyV210aFZrNUdVMnh3VjAxV1NrUlpWRVpLWlVaa2MxcEdhR2xoZWxaNFZsZHdTMkl4YkZkalJtaHJVakJhVDFSV1dtRmxiRmw1WlVkMGFFMVZiRE5VYkZaclZsZEtSMk5JU2xkU00yaG9WakJrVW1WdFRrZGFSMnhZVWpKb1ZsWnNhSGRSYlZaSFZHdGtWR0pIZUc5VmFrSmhWa1phY1ZOdE9WZGlSMUpaV2tWa01HRlZNWEppUkZKWFlsUldTRlpYTVV0V2JHUnpZVVp3YUUxWVFYcFdSbFpoWkRGYWRGSnJhR3RTYkZwdldsZDBZVmRXWkZWUmJUbHFUVlpzTTFSV2FFZFZNa1Y1WVVkR1YyRnJOWFpaVlZweVpWVXhWazlXVGxkaE1XOTNWbGN4TkZReFdYZE5WbHBZVjBoQ1dGbHNVa2ROTVZZMlVtczFiRlpzU2pGV1IzaFhZVmRGZWxGdVdsZFdla0kwVmxSR1lWSXhWbk5XYkZKcFZrZDRkMVpHV21Ga01sWlhWMnhvYTFKRlNsZFVWVkpIVjBac2NsVnNUbGROVlc4eVZtMTRiMVl5U2xWU2EzaFdZbGhvVUZsNlNrZFNNV1IwWWtaT2FFMHdTbUZXYlRGM1VqRnNWMkpHWkZSWFIyaHdWV3RhZDFaR2JITmFSRkpWVFZad2VGVnRkREJXUmxwMFZXeHNZVkpYVWtoV2FrRjRWakZrZFdOR2FHaE5WbkF5VjFaV1lWTXlUWGhVYms1WVlrZFNjRlpyVm1GV1ZscDBaRWRHYTAxWFVrbFdiWFJ6VmxkS1NGVnVRbFpoYTFwTVZHMTRZV05zYTNwaFIyeE9WbXhaTUZacVNqQlpWbVJJVW01T2FsSnRhRmhaVkVaaFpWWndWbGR1VG1wV2EzQjZXVEJrTkZVeVNsZFRiVVpZVmtWS2FGZFdaRWRXTVU1WllrZG9VMkpyU2xsWFYzaFRVbXN4UjJORlZsTmlhelZZVkZkek1WTkdXWGxsUnpsb1ZtMVNTRlV5TlhOV01rcFZVbGhrWVZKRmNGaFpla1pyWkZaV2NrNVdhRk5XUmxwYVZtdGFZVll5VFhkT1dFNXBVbXh3VjFsclpGTlhSbEpXVld0a1dGWnNjRmhaVldRd1YwWktjMk5FUWxkV00yaFFWMVphWVdNeVRraGhSbkJPWW0xbmVsWlhjRWRrTVU1SVUydG9hVkpyTlZsVmJGWnlaVVphZEUxVVVtaE5SRVpJVmpGb2IxWldaRWhsUmxaWFRVZFNkbGt3V2xka1JURlZWVzF3VjJKR2NEWldNblJoVkRKR2NrMVdaR3BTUlVwb1ZteGFXbVF4YkhKYVJYUlRUV3MxUmxWWGVGZFdNVnB5WTBac1YyRnJTbWhWTWpGU1pWWlNjbGR0YUZOaWEwcFFWbGN3TVZFd01YTlhia1pVWW01Q2MxVnRjekZUVmxaMFpFZEdhVkpyY0RCV1YzTTFWMjFLVlZKdVdscGhhMXBvV1RGYVIyUkdTbk5hUlRWb1pXeFpNbFl4VWtOV01rbDRWbGhzVkdFeWFGZFpXSEJ6Vm14YWRXTkZaR3RpUmxZMVdsVmFkMkpHU25OWGJteGFUVWRSTUZaVVNrZE9iRXBWVVd4a1YxSldjREpYVjNCTFVqSk5lRlJ1VG1oU2JIQndWbXBLYjFkR1pGaGxSemxWWWxaYVNGWXhhR3RYUjBwSlVXNUtWVlpzY0ROYVZscDNVbXhhVlZKdGFGZGhNMEY0VmxaYWIyRXhaRWRYYTFwVVlrZG9ZVlpyVm1GamJHdzJVbTEwV0ZadVFraFhhMlJ2WVZaS1dWRnNjRmROVjFGM1dWUktTbVZXVm5WVWJHaFlVakZLV2xkWGVHOVZNVnBYVm01R1VtSlZXbFZWYlhoelRsWndWbUZIZEdoU2JIQXdWbGQwYzFkc1dsaFVWRVpYWVd0d1RGWnNXa3RXVmtaelkwZDRhRTB3U2xKV01XaDNVakpSZUZSc1pGVmliRXB5Vlcxek1WUXhVbFpXYm1SWFlrWnNORmRyVWtOWGJGbDRVbXBPVldKR1duSldNR1JMVTBkR1JrOVdaR2hOVm5CTlZtdFNSMVl5VWtoV2EyeFZZWHBzVkZsclpETk5WbHBJWlVaYVQxWXdXa2xWTW5SaFlXeEtkR1ZIUmxkaVJuQXpXa2Q0WVdOV1RuSmFSM0JvWld4YVdWWnNaRFJoTVZWNFYyNVdVbUZzY0ZoWmJHaHZZVVpXY1ZKdGRGaFNhM0I1VjJ0YVYyRldTWGhUYmxwWFVteEtSRlV5YzNoak1XUjFWVzEwVTAweFNsRldWekI0VGtaa1IxZHVUbWhUUlRWWVZXcENWMDVHYTNkWGJrNVhUVVJHU1ZsVlZsTldNREZIWTBkb1dtVnJXbkphUmxwM1VqRlNjazVXWkdoTlYzUXpWbTB4ZDFNd01VZFZXR2hZWW14S1ZWbFVSbmRXVm14eVYyNWtWMkpHY0hwV01uUnJWR3N4VjFkcmFGWmlSa3A2VmxaYVYxWlZNVVZoZWpBOQ=="}}}}}},"responses":{"201":{"description":"File successfully uploaded.","content":{"application/json":{"schema":{"type":"object","properties":{"file_id":{"type":"string","description":"The file's unique ID.","example":"xBvggqyjQUal6TecwMlYwE"}}}}}},"400":{"description":"**HTTP Status Code:** `400` <br>\n Bad Request  \n\n **Error Code:** `124` <br>\n Invalid access token. <br>\n**Error Code:** `300` <br>\n Invalid File type.\nExceed max file size: ${maxSize} megabytes. <br>\n"},"429":{"description":"**HTTP Status Code:** `429` <br>\n Too Many Requests. For more information, see [rate limits](https://developers.zoom.us/docs/api/rate-limits/). \n\n "}},"security":[{"openapi_oauth":["tasks_file:write","tasks_file:write:admin","tasks:write:file","tasks:write:file:admin"],"openapi_authorization":[]}],"x-extensions":{"x-permissions":["TasksMgt:Edit"],"x-macro-scopes":["tasks_file:write","tasks_file:write:admin"],"x-granular-scopes":["tasks:write:file","tasks:write:file:admin"]}}},"/tasks/imports":{"post":{"tags":["Import"],"summary":"Submit a task import job","description":"Submit an asynchronous import job to import tasks from an external platform into Zoom Tasks. Use the `file_id` returned from the **Upload an import file** endpoint.\n\nThe import job is processed asynchronously. Use **Get import job status** to poll the progress and results.\n\n**Field mapping (Slack Lists to Zoom Tasks)**\n\nSlack Lists has two schema patterns. This endpoint supports both.\n\n1. **Todo mode** - schema contains task-oriented columns such as `todo_completed`, `todo_due_date`, and `todo_assignee`.\n2. **Normal mode** - schema does not contain `todo_completed`. Status is inferred from `select` columns when `status_mapping` is provided.\n\n| Slack Column Type | Zoom Tasks Field | Notes |\n|---|---|---|\n| `text` + `is_primary_column: true` | Title | Required. The main task name column. |\n| `text` + `is_primary_column: false` | Description | Non-primary text columns (for example, \"Description\"). |\n| `todo_assignee` / `user` | Assignee | Slack user ID is mapped to Zoom user by email. See `user_mapping`. |\n| `todo_due_date` / `date` | Due date | Mapped as-is in `yyyy-MM-dd` format. |\n| `todo_completed` | Status | Todo mode only. `true` -> `done`, `false` -> `to_do` when no `status_mapping` match is found. |\n| `select` | Status | Used in both modes. Option label is matched against `status_mapping` keys. In normal mode, this is the primary status source. |\n| `rating` | Priority | 1 star -> `Low`, 2 stars -> `Medium`, 3 stars -> `High`. |\n| `number` / `checkbox` / `email` / `phone` / `channel` / `link` / `message` / `vote` / `reference` / `attachment` / `canvas` | Description (appended) | Preserved as custom fields. `Custom Fields: {column name}: {value}`. |\n\n**Status precedence** if `status_mapping` resolves a value from `select`, that value is used first; otherwise the importer falls back to `todo_completed` and then `to_do` as the default.\n\n**[Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `tasks:write`,`tasks:write:admin`\n\n**[Granular Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `tasks:write:import`,`tasks:write:import:admin`\n\n**[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `LIGHT`","operationId":"submitTasksImportJob","requestBody":{"content":{"application/json":{"schema":{"required":["file_id","source"],"type":"object","properties":{"file_id":{"type":"string","description":"The uploaded file's unique identifier. Obtain this value from the [**Upload an import file**](/docs/api-reference/tasks/methods#operation/uploadTasksImportFile) endpoint.","example":"Fxxxxxxxxxxxxxxx"},"source":{"type":"string","description":"The import file's source platform.","example":"slack_lists","enum":["slack_lists"]},"user_mapping":{"type":"object","additionalProperties":{"type":"string","format":"email"},"description":"Optional. A mapping from source platform user IDs to Zoom user email addresses. If not provided, the service attempts to match users by email address automatically. Unmatched users will be recorded in the import result.","example":{"U09QEC12GE5":"user1@example.com","U09PZDF6H3Q":"user2@example.com"}},"status_mapping":{"type":"object","additionalProperties":{"type":"string","enum":["To do","In progress","Done","Blocked"]},"description":"Optional. A mapping from source platform status names to Zoom Tasks status display names. This mapping is resolved from Slack `select` option labels. Allowed values are `To do`, `In progress`, `Done`, and `Blocked`. If no mapping is resolved, the importer falls back to `todo_completed` in todo mode (`true` -> `Done`) and defaults to `To do` in normal mode.","example":{"Not started":"To do","In progress":"In progress","Blocked":"Blocked","Done":"Done"}}}}}}},"responses":{"202":{"description":"Import job submitted successfully. The job is being processed asynchronously.","content":{"application/json":{"schema":{"required":["import_id"],"type":"object","properties":{"import_id":{"type":"string","description":"The import job's unique identifier. Use this to poll the job status.","example":"imp_abc123"},"status":{"type":"string","description":"The import job's initial status.","example":"pending","enum":["pending"]},"submitted_at":{"type":"string","description":"The date and time the import job was submitted, in ISO 8601 format.","format":"date-time","example":"2026-04-15T10:06:30Z"}}}}}},"400":{"description":"**HTTP Status Code:** `400` <br>\n Bad Request  \n\n **Error Code:** `34002` <br>\n Invalid parameter. Possible reasons: `file_id` is invalid or expired, `source` is not supported, or a `status_mapping` value is not one of the allowed statuses. <br>\n"},"403":{"description":"**HTTP Status Code:** `403` <br>\n Forbidden  \n\n **Error Code:** `111800` <br>\n You do not have permission to submit an import job, or the `file_id` does not belong to the current user.  <br>\n"},"429":{"description":"**HTTP Status Code:** `429` <br>\n Too Many Requests. For more information, see [rate limits](https://developers.zoom.us/docs/api/rate-limits/). \n\n "}},"security":[{"openapi_oauth":["tasks:write","tasks:write:admin","tasks:write:import","tasks:write:import:admin"],"openapi_authorization":[]}],"x-extensions":{"x-permissions":["TasksMgt:Edit"],"x-macro-scopes":["tasks:write","tasks:write:admin"],"x-granular-scopes":["tasks:write:import","tasks:write:import:admin"]}}},"/tasks/imports/{importId}":{"get":{"tags":["Import"],"summary":"Get import job status","description":"Retrieve an import job's current status and results. Poll this endpoint after submitting an import job via [**Submit a task import job**](/docs/api-reference/tasks/methods#operation/submitTasksImportJob).\n\n**Job lifecycle** `pending` > `processing` > `completed` or `failed`\n\n**Polling recommendation** Poll every 3-5 seconds. Stop when status is `completed` or `failed`. Import job results are retained for 7 days.\n\n**[Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `tasks:read`,`tasks:read:admin`\n\n**[Granular Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `tasks:read:import`,`tasks:read:import:admin`\n\n**[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `LIGHT`\n\n**Not supported in Gov cluster** ","operationId":"getTasksImportJob","parameters":[{"name":"importId","in":"path","description":"The import job's unique identifier.","required":true,"schema":{"type":"string","example":"imp_abc123"}}],"responses":{"200":{"description":"Import job status retrieved successfully.","content":{"application/json":{"schema":{"required":["import_id","source","status","submitted_at","total_tasks"],"type":"object","properties":{"import_id":{"type":"string","description":"The import job's unique identifier.","example":"imp_abc123"},"status":{"type":"string","description":"The import job's current status.","example":"completed","enum":["pending","processing","completed","failed"]},"source":{"type":"string","description":"The import's source platform.","example":"slack_lists","enum":["slack_lists"]},"submitted_at":{"type":"string","description":"The date and time the import job was submitted, in ISO 8601 format.","format":"date-time","example":"2026-04-15T10:06:30Z"},"completed_at":{"type":"string","description":"The date and time the import job was completed, in ISO 8601 format. Only present when status is `completed` or `failed`.","format":"date-time","example":"2026-04-15T10:06:45Z"},"project_name":{"type":"string","description":"The title of the imported list from the source platform. Only present when status is `completed`.","example":"Project tracker"},"project_id":{"type":"string","description":"The ID of the imported project from the source platform. Only present when status is `completed`.","example":"project_id_123"},"project_link":{"type":"string","description":"The link of the imported project from the source platform. Only present when status is `completed`.","example":"https://tasks.example.com/project/project_id_123"},"total_tasks":{"type":"integer","description":"Total number of tasks found in the source file. Present when status is `processing`, `completed`, or `failed`.","example":1000},"processed_tasks":{"type":"integer","description":"Number of tasks processed so far. Only present when status is `processing`.","example":430},"successful_tasks":{"type":"integer","description":"Number of tasks successfully imported into Zoom Tasks. Present when status is `processing` or `completed`.","example":993},"failed_tasks":{"type":"integer","description":"Number of tasks that failed to import. Present when status is `processing` or `completed`.","example":7},"failed_task_details":{"type":"array","description":"Details of tasks that failed to import. Only present when status is `completed` and `failed_tasks` > 0.","items":{"type":"object","properties":{"record_id":{"type":"string","description":"The failed task's record ID in the source platform.","example":"Rec0ABEDKGPQC"},"title":{"type":"string","description":"The failed task's title.","example":"Print welcome banner"},"error":{"type":"string","description":"The reason the task failed to import.","example":"Invalid due date format"}}}},"unmapped_users":{"type":"array","description":"List of source platform user IDs that could not be mapped to a Zoom user. Only present when status is `completed`.","example":["U09XYZ","U08ABC"],"items":{"type":"string"}},"warnings":{"type":"array","description":"Non-fatal warnings encountered during import. Only present when status is `completed`.","example":["2 tasks created without due date"],"items":{"type":"string"}},"error":{"type":"string","description":"The reason the entire import job failed. Only present when status is `failed`.","example":"Invalid file format: missing required field list_metadata"}}}}}},"403":{"description":"**HTTP Status Code:** `403` <br>\n Forbidden  \n\n **Error Code:** `111800` <br>\n You do not have permission to access this import job. <br>\n"},"404":{"description":"**HTTP Status Code:** `404` <br>\n Not Found  \n\n **Error Code:** `112100` <br>\n The import job was not found. It may have expired (results are retained for 7 days) or the ID is invalid.  <br>\n"},"429":{"description":"**HTTP Status Code:** `429` <br>\n Too Many Requests. For more information, see [rate limits](https://developers.zoom.us/docs/api/rate-limits/). \n\n "}},"security":[{"openapi_oauth":["tasks:read","tasks:read:admin","tasks:read:import","tasks:read:import:admin"],"openapi_authorization":[]}],"x-extensions":{"x-permissions":["TasksContent:Read"],"x-macro-scopes":["tasks:read","tasks:read:admin"],"x-granular-scopes":["tasks:read:import","tasks:read:import:admin"]}}},"/tasks/items":{"get":{"tags":["Tasks"],"summary":"List tasks","description":"Retrieves tasks assigned to, or created by, the current user with advanced filtering, sorting, and pagination options.\n\n**[Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `tasks:read`,`tasks:read:admin`\n\n**[Granular Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `tasks:read:list_tasks:admin`,`tasks:read:list_tasks`\n\n**[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `LIGHT`","operationId":"getMyTasks","parameters":[{"name":"page_size","in":"query","description":"The number of records returned from a single API call.","required":false,"schema":{"maximum":50,"type":"integer","example":10,"default":10}},{"name":"next_page_token","in":"query","description":"The next page token is used to paginate through large result sets. A next page token will be returned whenever the set of available results exceeds the current page size. The expiration period for this token is 15 minutes.","required":false,"schema":{"type":"string","example":"R4aF9Oj0fVM2hhezJTEmSKaBSkfesDwGy42"}},{"name":"search_key","in":"query","description":"Search keyword for task title and description.","required":false,"schema":{"maxLength":50,"type":"string","example":"project documentation"}},{"name":"sort_by","in":"query","description":"Determines the order in which tasks are returned.","required":false,"schema":{"type":"string","example":"due_date","default":"due_date","enum":["update_time","create_time","due_date","status","priority"]}},{"name":"sort_asc","in":"query","description":"Sort in ascending order (default depends on sort column)","required":false,"schema":{"type":"boolean","example":false}},{"name":"assignee_email","in":"query","description":"The email address of the assignee to search for.","required":false,"schema":{"type":"string","format":"email","example":"assignee@email.com"}},{"name":"due_date_start","in":"query","description":"Start date for due date filter. \n Format: (yyyy-mm-dd)","required":false,"schema":{"type":"string","format":"date","example":"2024-01-01"}},{"name":"due_date_end","in":"query","description":"End date for due date filter.\n Format: (yyyy-mm-dd)","required":false,"schema":{"type":"string","format":"date","example":"2024-12-31"}},{"name":"unread","in":"query","description":"Set to only return unread tasks for the current user.","required":false,"schema":{"type":"boolean","example":false}},{"name":"status","in":"query","description":"Current status of the task.","required":false,"schema":{"type":"string","example":"To do","default":"To do","enum":["To do","In progress","Done","Blocked","Recommended"]}},{"name":"starred","in":"query","description":"Filter tasks by star status.","required":false,"schema":{"type":"boolean","example":true}},{"name":"source_type","in":"query","description":"The source that created the task.","required":false,"schema":{"type":"string","example":"user","enum":["user","aic_meeting_summary","whiteboard","notes","docs","phone","chat","email","meeting","aic"]}}],"responses":{"200":{"description":"Tasks retrieved successfully","content":{"application/json":{"schema":{"required":["tasks","total_records"],"type":"object","properties":{"next_page_token":{"type":"string","description":"Use the next page token to paginate through a large set of results. A next page token is returned when the available results exceed the current page size. This token's expiration period is 15 minutes.","example":"qUEQqB1V0HVhJmwKFQrGOD"},"page_size":{"type":"integer","description":"The number of records returned per page in a single API call.","example":10},"total_records":{"type":"integer","description":"The total number of records found.","example":2},"tasks":{"type":"array","description":"List of tasks matching the query criteria.","items":{"required":["ai_generated","create_time","is_public","modify_time","priority","source_type","starred","status","task_id","title"],"type":"object","properties":{"task_id":{"type":"string","description":"The unique identifier of the task.","example":"z2vo9qNRRHKArlJqkVHNUw"},"title":{"type":"string","description":"The title of the task.","example":"Complete project documentation"},"description":{"maxLength":200,"minLength":0,"type":"string","description":"A description of the task that will be truncated. \n The maximum length is 200 characters.","example":"Write comprehensive documentation for the new API endpoints..."},"priority":{"type":"string","description":"The task's priority level.","example":"Medium","default":"Medium","enum":["Low","Medium","High","Highest"]},"status":{"type":"string","description":"The task's current status.","example":"To do","default":"To do","enum":["To do","In progress","Done","Blocked","Recommended"]},"is_public":{"type":"boolean","description":"Determines the task's visibility.\n* `true` - The task is accessible to all members of your organization.\n* `false` - The task is accessible only to the assigned users and collaborators.","example":false,"default":false},"due_date":{"type":"string","description":"The task's due date in UTC, formatted as `yyyy-MM-dd`.","format":"date","example":"2025-09-24"},"ai_generated":{"type":"boolean","description":"Whether the task was generated by AI.","example":false},"starred":{"type":"boolean","description":"Whether the task is starred by the user.","example":true},"unread":{"type":"boolean","description":"Whether the task is unread by the current user.","example":false},"assignees":{"maxItems":5,"minItems":0,"type":"array","description":"A list of all assignees associated with the task.\n Only the first 5 assignees are returned.","items":{"required":["display_name","user_id"],"type":"object","properties":{"user_id":{"type":"string","description":"The Zoom user ID of the assignee.","example":"CcrEGgmeQem1uyJsuIRKwA"},"display_name":{"type":"string","description":"The display name of the assignee.","example":"John Doe"},"email":{"type":"string","description":"The email address of the assignee.","format":"email","example":"john.doe@example.com"},"avatar":{"type":"string","description":"The avatar image URL of the assignee.","format":"uri","example":"https://example.com/avatar.jpg"}}}},"collaborators":{"type":"array","description":"A list of all collaborators associated with the task.\n Only the first 5 collaborators are returned.","items":{"required":["display_name","user_id"],"type":"object","properties":{"user_id":{"type":"string","description":"The Zoom user ID of the collaborator.","example":"CcrEGgmeQem1uyJsuIRKwA"},"display_name":{"type":"string","description":"The display name of the collaborator.","example":"John Doe"},"email":{"type":"string","description":"The email address of the collaborator.","format":"email","example":"john.doe@example.com"},"avatar":{"type":"string","description":"The avatar image URL of the collaborator.","format":"uri","example":"https://example.com/avatar.jpg"}}}},"friendly_task_id":{"type":"string","description":"The task friendly ID.","example":"Task-1"},"link":{"type":"string","description":"The task share link.","example":"https://tasks.zoomdev.us/ws53iQgOOkOdzVTxZaVoRA/TASK-1"},"create_time":{"type":"string","description":"The task create date-time in UTC/GMT.","format":"date-time","example":"2025-03-31T12:02:00Z"},"modify_time":{"type":"string","description":"The task modify date-time in UTC/GMT.","format":"date-time","example":"2025-03-31T12:02:00Z"},"source_type":{"type":"string","description":"Type of the source that created the task.","example":"user","enum":["user","aic_meeting_summary","whiteboard","notes","docs","phone","chat","email","meeting","aic"]}}}}}}}}},"400":{"description":"**HTTP Status Code:** `400` <br>\n Bad Request  \n\n **Error Code:** `38004` <br>\n invalid params {params_name} <br>\n"},"429":{"description":"**HTTP Status Code:** `429` <br>\n Too Many Requests. For more information, see [rate limits](https://developers.zoom.us/docs/api/rate-limits/). \n\n "}},"security":[{"openapi_oauth":["tasks:read","tasks:read:admin","tasks:read:list_tasks:admin","tasks:read:list_tasks"],"openapi_authorization":[]}],"x-extensions":{"x-permissions":["TasksMgt:Read","TasksContent:Read"],"x-macro-scopes":["tasks:read","tasks:read:admin"],"x-granular-scopes":["tasks:read:list_tasks:admin","tasks:read:list_tasks"]}},"post":{"tags":["Tasks"],"summary":"Create a new task","description":"Provide essential details to create a new task without file attachments.\n\n**[Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `tasks:write`\n\n**[Granular Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `tasks:write:task`\n\n**[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `LIGHT`","operationId":"createTask","requestBody":{"content":{"application/json":{"schema":{"required":["title"],"type":"object","properties":{"title":{"maxLength":500,"minLength":1,"type":"string","description":"The tasks's title. Maximum 500 characters.","example":"Complete project documentation"},"description":{"maxLength":10000,"minLength":1,"type":"string","description":"The task's detailed description. Maximum 10,000 characters.","example":"Write comprehensive documentation for the new API endpoints"},"priority":{"type":"string","description":"The task's priority level.","example":"Medium","default":"Medium","enum":["Low","Medium","High","Highest"]},"status":{"type":"string","description":"The task's current status.","example":"To do","default":"To do","enum":["To do","In progress","Done","Blocked","Recommended"]},"due_date":{"type":"string","description":"The task's due date in UTC, formatted as `yyyy-MM-dd`.","format":"date","example":"2025-09-24"},"is_public":{"type":"boolean","description":"Determines the task's visibility.\n* `true` - The task is accessible to all members of your organization.\n* `false` - The task is accessible only to the assigned users and collaborators.","example":false,"default":false},"starred":{"type":"boolean","description":"Whether the task is starred.","example":false,"default":false},"collaborators":{"maxItems":20,"minItems":0,"type":"array","description":"A list of collaborators to invite to the task. Maximum 20.","items":{"type":"object","properties":{"email":{"type":"string","description":"The email address of the collaborator to invite. The potential collaborator must belong to the same account as the requesting user.","example":"potential-collaborator@example.com"}}}},"invite_message":{"maxLength":280,"type":"string","description":"Include an optional message when inviting a user as a collaborator or assignee. Maximum length is 200 characters.","example":"Please join this task to help review the API documentation."},"skip_notifications":{"type":"boolean","description":"Whether to skip sending notifications to collaborators.","example":false},"assignees":{"maxItems":20,"minItems":0,"type":"array","description":"A list of assignees to add to the task. Maximum of 20. If empty, the request user is added by default.","items":{"type":"object","properties":{"email":{"type":"string","description":"The email address of the assignee to invite. The potential assignee must belong to the same account as the requesting user.","example":"invited-assignee@example.com"}}}}}}}}},"responses":{"201":{"description":"Task created successfully.","content":{"application/json":{"schema":{"required":["create_time","is_public","priority","starred","status","task_id","title"],"type":"object","properties":{"task_id":{"type":"string","description":"The created task's unique identifier.","example":"z2vo9qNRRHKArlJqkVHNUw"},"title":{"type":"string","description":"The task's title.","example":"Complete project documentation"},"description":{"type":"string","description":"The task's detailed description.","example":"Write comprehensive documentation for the new API endpoints"},"priority":{"type":"string","description":"The task's priority level.","example":"Medium","default":"Medium","enum":["Low","Medium","High","Highest"]},"status":{"type":"string","description":"The task's current status.","example":"To do","default":"To do","enum":["To do","In progress","Done","Blocked","Recommended"]},"is_public":{"type":"boolean","description":"Determines the task's visibility.\n* `true` - The task is accessible to all members of your organization.\n* `false` - The task is accessible only to the assigned users and collaborators.","example":false,"default":false},"due_date":{"type":"string","description":"The task's due date in UTC, formatted as `yyyy-MM-dd`.","format":"date","example":"2025-09-24"},"starred":{"type":"boolean","description":"Indicates whether the task is starred by the user.","example":false},"collaborators":{"maxItems":20,"minItems":0,"type":"array","description":"A list of collaborators associated with the task.","items":{"required":["user_id"],"type":"object","properties":{"user_id":{"type":"string","description":"The collaborator's Zoom user ID.","example":"w0RChiauQeqRlv5fgxYULQ"},"email":{"type":"string","description":"The email address of the collaborator.","example":"john.doe@example.com"}}}},"assignees":{"maxItems":20,"minItems":0,"type":"array","description":"A list of all assignees associated with the task. ","items":{"required":["user_id"],"type":"object","properties":{"user_id":{"type":"string","description":"The assignee's Zoom user ID.","example":"w0RChiauQeqRlv5fgxYULQ"},"email":{"type":"string","description":"The email address of the assignee.","example":"invited-assignee@example.com"}}}},"create_time":{"type":"string","description":"The creation date and time in UTC/GMT format. ","format":"date-time","example":"2025-03-25T07:29:29Z"},"friendly_task_id":{"type":"string","description":"The human-readable identifier of the task.","example":"Task-1"},"link":{"type":"string","description":"The direct URL link to the task.","example":"https://tasks.example.com/ws53iQgOOkOdzVTxZaVoRA/TASK-1"}}}}}},"400":{"description":"**HTTP Status Code:** `400` <br>\n Bad Request  \n\n **Error Code:** `34002` <br>\n Invalid email {email}. <br>\n**Error Code:** `34002` <br>\n The title is too long. <br>\n**Error Code:** `34002` <br>\n The description is too long. <br>\n**Error Code:** `34002` <br>\n Invalid field {field_name}. <br>\n"},"429":{"description":"**HTTP Status Code:** `429` <br>\n Too Many Requests. For more information, see [rate limits](https://developers.zoom.us/docs/api/rate-limits/). \n\n "}},"security":[{"openapi_oauth":["tasks:write","tasks:write:task"],"openapi_authorization":[]}],"x-extensions":{"x-permissions":[],"x-macro-scopes":["tasks:write"],"x-granular-scopes":["tasks:write:task"]}}},"/tasks/items/{taskId}":{"get":{"tags":["Tasks"],"summary":"Get task details","description":"Retrieves detailed information about a specific task by it’s ID\n\n**[Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `tasks:read`,`tasks:read:admin`\n\n**[Granular Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `tasks:read:task`,`tasks:read:task:admin`\n\n**[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `LIGHT`","operationId":"getTaskDetail","parameters":[{"name":"taskId","in":"path","description":"The unique identifier of the task.","required":true,"schema":{"type":"string","example":"z2vo9qNRRHKArlJqkVHNUw"}}],"responses":{"200":{"description":"Task details retrieved successfully","content":{"application/json":{"schema":{"required":["create_time","is_ai_generated","is_public","modify_time","priority","source_type","starred","status","task_id","title"],"type":"object","properties":{"task_id":{"type":"string","description":"The unique identifier of the task.","example":"z2vo9qNRRHKArlJqkVHNUw"},"title":{"type":"string","description":"The title of the task.","example":"the tasks title demo"},"description":{"type":"string","description":"A detailed description of the task.","example":"the task description"},"priority":{"type":"string","description":"The task's priority level.","example":"Medium","default":"Medium","enum":["Low","Medium","High","Highest"]},"status":{"type":"string","description":"The task's current status.","example":"To do","default":"To do","enum":["To do","In progress","Done","Blocked","Recommended"]},"is_public":{"type":"boolean","description":"Determines the task's visibility.\n* `true` - The task is accessible to all members of your organization.\n* `false` - The task is accessible only to the assigned users and collaborators.","example":false,"default":false},"due_date":{"type":"string","description":"The task's due date in UTC, formatted as `yyyy-MM-dd`.","format":"date","example":"2025-09-24"},"is_ai_generated":{"type":"boolean","description":"Whether the task was generated by AI.","example":false},"starred":{"type":"boolean","description":"Whether the task is starred by the user.","example":false},"tasks_attachments":{"type":"array","description":"List of attachments associated with the task","example":[],"items":{"type":"object","properties":{"attachment_id":{"type":"string","description":"The unique identifier of the attachment.","example":"dz6nqEeQT6C1VoZFxteGTw"},"file_name":{"type":"string","description":"The name of the attached file.","example":"example.pdf"},"file_size":{"type":"integer","description":"The size of the file in bytes.","example":1024},"mime_type":{"type":"string","description":"The MIME type of the file.","example":"application/pdf"},"upload_time":{"type":"string","description":"The file upload date-time in UTC/GMT.","format":"date-time","example":"2025-03-31T12:02:00Z"},"download_url":{"type":"string","description":"The download link for the attachment will remain valid for 7,200 seconds.","example":"https://file.zoom.us/file/dz6nqEeQT6C1VoZFxteGTw?jwt=xxx"}}}},"assignees":{"type":"array","description":"A list of all assignees associated with the task. ","items":{"required":["display_name","user_id"],"type":"object","properties":{"user_id":{"type":"string","description":"The Zoom user ID of the assignee.","example":"w0RChiauQeqRlv5fgxYULQ"},"display_name":{"type":"string","description":"The display name of the assignee.","example":"John Doe"},"email":{"type":"string","description":"The email address of the assignee.","format":"email","example":"john.doe@example.com"},"avatar":{"type":"string","description":"The avatar image URL of the assignee.","format":"uri","example":"https://example.com/avatar.jpg"}}}},"collaborators":{"type":"array","description":"A list of all collaborators associated with the task.","items":{"required":["display_name","user_id"],"type":"object","properties":{"user_id":{"type":"string","description":"The Zoom user ID of the collaborator.","example":"w0RChiauQeqRlv5fgxYULQ"},"display_name":{"type":"string","description":"The display name of the collaborator.","example":"John Doe"},"email":{"type":"string","description":"The email address of the collaborator.","format":"email","example":"john.doe@example.com"},"avatar":{"type":"string","description":"The avatar image URL of the collaborator.","format":"uri","example":"https://example.com/avatar.jpg"}}}},"source_type":{"type":"string","description":"Type of the source that created the task.","example":"user","enum":["user","aic_meeting_summary","whiteboard","notes","docs","phone","chat","email","meeting","aic"]},"friendly_task_id":{"type":"string","description":"The task friendly ID.","example":"Task-1"},"link":{"type":"string","description":"The task share link.","example":"https://tasks.zoomdev.us/ws53iQgOOkOdzVTxZaVoRA/TASK-1"},"associated_meeting":{"type":"object","properties":{"id":{"type":"integer","description":"[Meeting ID](https://support.zoom.us/hc/en-us/articles/201362373-What-is-a-Meeting-ID-): Unique identifier of the meeting in **long** format, represented as int64 data type in JSON, also known as the meeting number.","format":"int64","example":97763643886},"uuid":{"type":"string","description":"The unique Meeting ID. Each meeting instance will generate its own Meeting UUID.","example":"aDYlohsHRtCd4ii1uC2+hA=="},"topic":{"type":"string","description":"The topic of the associated meeting","example":"Tasks Meeting"},"meeting_date":{"type":"string","description":"The meeting start date-time in UTC/GMT.","format":"date-time","example":"2025-03-31T12:02:00Z"}},"description":"Associated meeting information"},"create_time":{"type":"string","description":"The task create date-time in UTC/GMT.","format":"date-time","example":"2025-03-31T12:02:00Z"},"modify_time":{"type":"string","description":"The task modify date-time in UTC/GMT.","format":"date-time","example":"2025-03-31T12:02:00Z"}}}}}},"403":{"description":"**HTTP Status Code:** `403` <br>\n Forbidden  \n\n **Error Code:** `111800` <br>\n You don't have permission to request the task. <br>\n"},"404":{"description":"**HTTP Status Code:** `404` <br>\n Not Found  \n\n **Error Code:** `112100` <br>\n The resource not found. <br>\n"},"429":{"description":"**HTTP Status Code:** `429` <br>\n Too Many Requests. For more information, see [rate limits](https://developers.zoom.us/docs/api/rate-limits/). \n\n "}},"security":[{"openapi_oauth":["tasks:read","tasks:read:admin","tasks:read:task","tasks:read:task:admin"],"openapi_authorization":[]}],"x-extensions":{"x-permissions":["TasksMgt:Read","TasksContent:Read"],"x-macro-scopes":["tasks:read","tasks:read:admin"],"x-granular-scopes":["tasks:read:task","tasks:read:task:admin"]}},"delete":{"tags":["Tasks"],"summary":"Delete a task","description":"Permanently delete a task and all its associated data including descriptions, attachments, collaborators, and integrations. This operation cannot be undone.\n\n**[Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `tasks:delete`,`tasks:delete:admin`\n\n**[Granular Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `tasks:delete:task:admin`,`tasks:delete:task`\n\n**[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `LIGHT`","operationId":"deleteTask","parameters":[{"name":"taskId","in":"path","description":"The unique identifier of the task to delete","required":true,"schema":{"type":"string","example":"z2vo9qNRRHKArlJqkVHNUw"}}],"responses":{"204":{"description":"Task deleted successfully"},"403":{"description":"**HTTP Status Code:** `403` <br>\n Forbidden  \n\n **Error Code:** `111800` <br>\n You don't have permission to request the task. <br>\n"},"404":{"description":"**HTTP Status Code:** `404` <br>\n Not Found  \n\n **Error Code:** `112100` <br>\n The resource not found. <br>\n"},"429":{"description":"**HTTP Status Code:** `429` <br>\n Too Many Requests. For more information, see [rate limits](https://developers.zoom.us/docs/api/rate-limits/). \n\n "}},"security":[{"openapi_oauth":["tasks:delete","tasks:delete:admin","tasks:delete:task:admin","tasks:delete:task"],"openapi_authorization":[]}],"x-extensions":{"x-permissions":["TasksMgt:Edit"],"x-macro-scopes":["tasks:delete","tasks:delete:admin"],"x-granular-scopes":["tasks:delete:task:admin","tasks:delete:task"]}},"patch":{"tags":["Tasks"],"summary":"Update task fields","description":"Updates specific fields of an existing task. Only provided fields will be updated, others will remain unchanged.\n\n**[Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `tasks:write`,`tasks:write:admin`\n\n**[Granular Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `tasks:update:task`,`tasks:update:task:admin`\n\n**[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `LIGHT`","operationId":"updateTask","parameters":[{"name":"taskId","in":"path","description":"The unique identifier of the task to update","required":true,"schema":{"type":"string","example":"z2vo9qNRRHKArlJqkVHNUw"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"title":{"maxLength":500,"minLength":1,"type":"string","description":"The title of the task. \nMaximum 500 characters.","example":"Complete project documentation"},"description":{"maxLength":10000,"minLength":1,"type":"string","description":"A detailed description of the task. \nMaximum 10,000 characters.","example":"Write comprehensive documentation for the new API endpoints"},"priority":{"type":"string","description":"The task's priority level.","example":"Medium","default":"Medium","enum":["Low","Medium","High","Highest"]},"status":{"type":"string","description":"The task's current status.","example":"To do","default":"To do","enum":["To do","In progress","Done","Blocked","Recommended"]},"due_date":{"type":"string","description":"The task's due date in UTC, formatted as `yyyy-MM-dd`.","format":"date","example":"2025-09-24"},"is_public":{"type":"boolean","description":"Determines the task's visibility.\n* `true` - The task is accessible to all members of your organization.\n* `false` - The task is accessible only to the assigned users and collaborators.","example":false,"default":false},"starred":{"type":"boolean","description":"Whether the task should be starred.","example":true}}}}}},"responses":{"204":{"description":"Task updated successfully"},"400":{"description":"**HTTP Status Code:** `400` <br>\n Bad Request  \n\n **Error Code:** `34002` <br>\n Invalid field {field_name}. <br>\n**Error Code:** `34002` <br>\n The title is too long. <br>\n**Error Code:** `34002` <br>\n The description is too long. <br>\n"},"403":{"description":"**HTTP Status Code:** `403` <br>\n Forbidden  \n\n **Error Code:** `111800` <br>\n You don't have permission to request the task. <br>\n"},"429":{"description":"**HTTP Status Code:** `429` <br>\n Too Many Requests. For more information, see [rate limits](https://developers.zoom.us/docs/api/rate-limits/). \n\n "}},"security":[{"openapi_oauth":["tasks:write","tasks:write:admin","tasks:update:task","tasks:update:task:admin"],"openapi_authorization":[]}],"x-extensions":{"x-permissions":["TasksMgt:Edit"],"x-macro-scopes":["tasks:write","tasks:write:admin"],"x-granular-scopes":["tasks:update:task","tasks:update:task:admin"]}}}},"components":{"securitySchemes":{"openapi_authorization":{"type":"apiKey","name":"Authorization","in":"header"},"openapi_oauth":{"type":"oauth2","flows":{"authorizationCode":{"authorizationUrl":"/","tokenUrl":"","refreshUrl":"","scopes":{"tasks_assignee:write":"tasks_assignee:write","tasks_assignee:write:admin":"tasks_assignee:write:admin","tasks:write:assignees":"tasks:write:assignees","tasks:write:assignees:admin":"tasks:write:assignees:admin","tasks_assignee:read:admin":"tasks_assignee:read:admin","tasks_assignee:read":"tasks_assignee:read","tasks:read:assignees":"tasks:read:assignees","tasks:read:assignees:admin":"tasks:read:assignees:admin","tasks:delete:assignees":"tasks:delete:assignees","tasks:delete:assignees:admin":"tasks:delete:assignees:admin","tasks_collaborator:read:admin":"tasks_collaborator:read:admin","tasks_collaborator:read":"tasks_collaborator:read","tasks:read:list_collaborators":"tasks:read:list_collaborators","tasks:read:list_collaborators:admin":"tasks:read:list_collaborators:admin","tasks_collaborator:write":"tasks_collaborator:write","tasks_collaborator:write:admin":"tasks_collaborator:write:admin","tasks:write:collaborators":"tasks:write:collaborators","tasks:write:collaborators:admin":"tasks:write:collaborators:admin","tasks:delete:collaborator:admin":"tasks:delete:collaborator:admin","tasks:delete:collaborator":"tasks:delete:collaborator","tasks_comment:write":"tasks_comment:write","tasks_comment:write:admin":"tasks_comment:write:admin","tasks:write:comment:admin":"tasks:write:comment:admin","tasks:write:comment":"tasks:write:comment","tasks_comment:read":"tasks_comment:read","tasks_comment:read:admin":"tasks_comment:read:admin","tasks:read:comments":"tasks:read:comments","tasks:read:comments:admin":"tasks:read:comments:admin","tasks:delete:comment:admin":"tasks:delete:comment:admin","tasks:delete:comment":"tasks:delete:comment","tasks_file:write":"tasks_file:write","tasks_file:write:admin":"tasks_file:write:admin","tasks:write:file":"tasks:write:file","tasks:write:file:admin":"tasks:write:file:admin","tasks:write":"tasks:write","tasks:write:admin":"tasks:write:admin","tasks:write:import":"tasks:write:import","tasks:write:import:admin":"tasks:write:import:admin","tasks:read":"tasks:read","tasks:read:admin":"tasks:read:admin","tasks:read:import":"tasks:read:import","tasks:read:import:admin":"tasks:read:import:admin","tasks:write:task":"tasks:write:task","tasks:read:list_tasks:admin":"tasks:read:list_tasks:admin","tasks:read:list_tasks":"tasks:read:list_tasks","tasks:read:task":"tasks:read:task","tasks:read:task:admin":"tasks:read:task:admin","tasks:delete":"tasks:delete","tasks:delete:admin":"tasks:delete:admin","tasks:delete:task:admin":"tasks:delete:task:admin","tasks:delete:task":"tasks:delete:task","tasks:update:task":"tasks:update:task","tasks:update:task:admin":"tasks:update:task:admin"}}}}}}}