Use wide Tasks API integration

With Ants & Apps platform you can connect Tasks API with more than 30 available apps, 600+ functional formulas to boost your productivity

Reference

  • tasklists

    • Return the authenticated user's specified task list

      This action returns the authenticated user's specified task list.

      GETTasksTasklistsGet

      Request parameters

      • tasklist*string

        Task list identifier.

    • Return all the authenticated user's task lists

      This action returns all the authenticated user's task lists.

      GETTasksTasklistsList

      Request parameters

      • maxResultsstring

        Maximum number of task lists returned on one page. Optional. The default is 20 (max allowed: 100).

      • pageTokenstring

        Token specifying the result page to return. Optional.

    • Create a new task list and adds it to the authenticated user's task lists

      This action creates a new task list and adds it to the authenticated user's task lists.

      POSTTasksTasklistsInsert

      Request body

      • etagstring

        ETag of the resource.

      • idstring

        Task list identifier.

      • kindstring

        Type of the resource. This is always "tasks#taskList".

      • selfLinkstring

        URL pointing to this task list. Used to retrieve, update, or delete this task list.

      • titlestring

        Title of the task list.

      • updatedstring

        Last modification time of the task list (as a RFC 3339 timestamp).

    • Update the authenticated user's specified task list

      This action updates the authenticated user's specified task list.

      PUTTasksTasklistsUpdate

      Request parameters

      • tasklist*string

        Task list identifier.

      Request body

      • etagstring

        ETag of the resource.

      • idstring

        Task list identifier.

      • kindstring

        Type of the resource. This is always "tasks#taskList".

      • selfLinkstring

        URL pointing to this task list. Used to retrieve, update, or delete this task list.

      • titlestring

        Title of the task list.

      • updatedstring

        Last modification time of the task list (as a RFC 3339 timestamp).

    • Update the authenticated user's specified task list

      This action updates the authenticated user's specified task list. This method supports patch semantics.

      PATCHTasksTasklistsPatch

      Request parameters

      • tasklist*string

        Task list identifier.

      Request body

      • etagstring

        ETag of the resource.

      • idstring

        Task list identifier.

      • kindstring

        Type of the resource. This is always "tasks#taskList".

      • selfLinkstring

        URL pointing to this task list. Used to retrieve, update, or delete this task list.

      • titlestring

        Title of the task list.

      • updatedstring

        Last modification time of the task list (as a RFC 3339 timestamp).

    • Delete the authenticated user's specified task list

      This action deletes the authenticated user's specified task list.

      DELETETasksTasklistsDelete

      Request parameters

      • tasklist*string

        Task list identifier.

  • tasks

    • Return the specified task

      This action returns the specified task.

      GETTasksTasksGet

      Request parameters

      • task*string

        Task identifier.

      • tasklist*string

        Task list identifier.

    • Return all tasks in the specified task list

      This action returns all tasks in the specified task list.

      GETTasksTasksList

      Request parameters

      • tasklist*string

        Task list identifier.

      • completedMaxstring

        Upper bound for a task's completion date (as a RFC 3339 timestamp) to filter by. Optional. The default is not to filter by completion date.

      • completedMinstring

        Lower bound for a task's completion date (as a RFC 3339 timestamp) to filter by. Optional. The default is not to filter by completion date.

      • dueMaxstring

        Upper bound for a task's due date (as a RFC 3339 timestamp) to filter by. Optional. The default is not to filter by due date.

      • dueMinstring

        Lower bound for a task's due date (as a RFC 3339 timestamp) to filter by. Optional. The default is not to filter by due date.

      • maxResultsstring

        Maximum number of task lists returned on one page. Optional. The default is 20 (max allowed: 100).

      • pageTokenstring

        Token specifying the result page to return. Optional.

      • showCompletedboolean

        Flag indicating whether completed tasks are returned in the result. Optional. The default is True.

      • showDeletedboolean

        Flag indicating whether deleted tasks are returned in the result. Optional. The default is False.

      • showHiddenboolean

        Flag indicating whether hidden tasks are returned in the result. Optional. The default is False.

      • updatedMinstring

        Lower bound for a task's last modification time (as a RFC 3339 timestamp) to filter by. Optional. The default is not to filter by last modification time.

    • Clear all completed tasks from the specified task list

      This action clears all completed tasks from the specified task list. The affected tasks will be marked as 'hidden' and no longer be returned by default when retrieving all tasks for a task list.

      POSTTasksTasksClear

      Request parameters

      • tasklist*string

        Task list identifier.

    • Create a new task on the specified task list

      This action creates a new task on the specified task list.

      POSTTasksTasksInsert

      Request parameters

      • tasklist*string

        Task list identifier.

      • parentstring

        Parent task identifier. If the task is created at the top level, this parameter is omitted. Optional.

      • previousstring

        Previous sibling task identifier. If the task is created at the first position among its siblings, this parameter is omitted. Optional.

      Request body

      • completedstring

        Completion date of the task (as a RFC 3339 timestamp). This field is omitted if the task has not been completed.

      • deletedboolean

        Flag indicating whether the task has been deleted. The default if False.

      • duestring

        Due date of the task (as a RFC 3339 timestamp). Optional. The due date only records date information; the time portion of the timestamp is discarded when setting the due date. It isn't possible to read or write the time that a task is due via the API.

      • etagstring

        ETag of the resource.

      • hiddenboolean

        Flag indicating whether the task is hidden. This is the case if the task had been marked completed when the task list was last cleared. The default is False. This field is read-only.

      • idstring

        Task identifier.

      • kindstring

        Type of the resource. This is always "tasks#task".

      • linksarray

        Collection of links. This collection is read-only.

      • notesstring

        Notes describing the task. Optional.

      • parentstring

        Parent task identifier. This field is omitted if it is a top-level task. This field is read-only. Use the "move" method to move the task under a different parent or to the top level.

      • positionstring

        String indicating the position of the task among its sibling tasks under the same parent task or at the top level. If this string is greater than another task's corresponding position string according to lexicographical ordering, the task is positioned after the other task under the same parent task (or at the top level). This field is read-only. Use the "move" method to move the task to another position.

      • selfLinkstring

        URL pointing to this task. Used to retrieve, update, or delete this task.

      • statusstring

        Status of the task. This is either "needsAction" or "completed".

      • titlestring

        Title of the task.

      • updatedstring

        Last modification time of the task (as a RFC 3339 timestamp).

      • scheduleTimestring

        The time when the task is scheduled to be attempted or retried. `schedule_time` will be truncated to the nearest microsecond.

      • createTimestring

        Output only. The time that the task was created. `create_time` will be truncated to the nearest second.

      • namestring

        Optionally caller-specified in CreateTask. The task name. The task name must have the following format: `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID/tasks/TASK_ID` * `PROJECT_ID` can contain letters ([A-Za-z]), numbers ([0-9]), hyphens (-), colons (:), or periods (.). For more information, see [Identifying projects](https://cloud.google.com/resource-manager/docs/creating-managing-projects#identifying_projects) * `LOCATION_ID` is the canonical ID for the task's location. The list of available locations can be obtained by calling ListLocations. For more information, see https://cloud.google.com/about/locations/. * `QUEUE_ID` can contain letters ([A-Za-z]), numbers ([0-9]), or hyphens (-). The maximum length is 100 characters. * `TASK_ID` can contain only letters ([A-Za-z]), numbers ([0-9]), hyphens (-), or underscores (_). The maximum length is 500 characters.

      • dispatchDeadlinestring

        The deadline for requests sent to the worker. If the worker does not respond by this deadline then the request is cancelled and the attempt is marked as a `DEADLINE_EXCEEDED` failure. Cloud Tasks will retry the task according to the RetryConfig. Note that when the request is cancelled, Cloud Tasks will stop listing for the response, but whether the worker stops processing depends on the worker. For example, if the worker is stuck, it may not react to cancelled requests. The default and maximum values depend on the type of request: * For App Engine tasks, 0 indicates that the request has the default deadline. The default deadline depends on the [scaling type](https://cloud.google.com/appengine/docs/standard/go/how-instances-are-managed#instance_scaling) of the service: 10 minutes for standard apps with automatic scaling, 24 hours for standard apps with manual and basic scaling, and 60 minutes for flex apps. If the request deadline is set, it must be in the interval [15 seconds, 24 hours 15 seconds]. Regardless of the task's `dispatch_deadline`, the app handler will not run for longer than than the service's timeout. We recommend setting the `dispatch_deadline` to at most a few seconds more than the app handler's timeout. For more information see [Timeouts](https://cloud.google.com/tasks/docs/creating-appengine-handlers#timeouts). `dispatch_deadline` will be truncated to the nearest millisecond. The deadline is an approximate deadline.

      • dispatchCountinteger

        Output only. The number of attempts dispatched. This count includes attempts which have been dispatched but haven't received a response.

      • firstAttemptobject

        Output only. The status of the task's first attempt. Only dispatch_time will be set. The other Attempt information is not retained by Cloud Tasks.

      • lastAttemptobject

        Output only. The status of the task's last attempt.

      • responseCountinteger

        Output only. The number of attempts which have received a response.

      • appEngineHttpRequestobject

        HTTP request that is sent to the App Engine app handler. An App Engine task is a task that has AppEngineHttpRequest set.

      • viewstring

        Output only. The view specifies which subset of the Task has been returned.

    • Move the specified task to another position in the task list

      This action moves the specified task to another position in the task list. This can include putting it as a child task under a new parent and/or move it to a different position among its sibling tasks.

      POSTTasksTasksMove

      Request parameters

      • task*string

        Task identifier.

      • tasklist*string

        Task list identifier.

      • parentstring

        New parent task identifier. If the task is moved to the top level, this parameter is omitted. Optional.

      • previousstring

        New previous sibling task identifier. If the task is moved to the first position among its siblings, this parameter is omitted. Optional.

    • Update the specified task

      This action updates the specified task.

      PUTTasksTasksUpdate

      Request parameters

      • task*string

        Task identifier.

      • tasklist*string

        Task list identifier.

      Request body

      • completedstring

        Completion date of the task (as a RFC 3339 timestamp). This field is omitted if the task has not been completed.

      • deletedboolean

        Flag indicating whether the task has been deleted. The default if False.

      • duestring

        Due date of the task (as a RFC 3339 timestamp). Optional. The due date only records date information; the time portion of the timestamp is discarded when setting the due date. It isn't possible to read or write the time that a task is due via the API.

      • etagstring

        ETag of the resource.

      • hiddenboolean

        Flag indicating whether the task is hidden. This is the case if the task had been marked completed when the task list was last cleared. The default is False. This field is read-only.

      • idstring

        Task identifier.

      • kindstring

        Type of the resource. This is always "tasks#task".

      • linksarray

        Collection of links. This collection is read-only.

      • notesstring

        Notes describing the task. Optional.

      • parentstring

        Parent task identifier. This field is omitted if it is a top-level task. This field is read-only. Use the "move" method to move the task under a different parent or to the top level.

      • positionstring

        String indicating the position of the task among its sibling tasks under the same parent task or at the top level. If this string is greater than another task's corresponding position string according to lexicographical ordering, the task is positioned after the other task under the same parent task (or at the top level). This field is read-only. Use the "move" method to move the task to another position.

      • selfLinkstring

        URL pointing to this task. Used to retrieve, update, or delete this task.

      • statusstring

        Status of the task. This is either "needsAction" or "completed".

      • titlestring

        Title of the task.

      • updatedstring

        Last modification time of the task (as a RFC 3339 timestamp).

      • scheduleTimestring

        The time when the task is scheduled to be attempted or retried. `schedule_time` will be truncated to the nearest microsecond.

      • createTimestring

        Output only. The time that the task was created. `create_time` will be truncated to the nearest second.

      • namestring

        Optionally caller-specified in CreateTask. The task name. The task name must have the following format: `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID/tasks/TASK_ID` * `PROJECT_ID` can contain letters ([A-Za-z]), numbers ([0-9]), hyphens (-), colons (:), or periods (.). For more information, see [Identifying projects](https://cloud.google.com/resource-manager/docs/creating-managing-projects#identifying_projects) * `LOCATION_ID` is the canonical ID for the task's location. The list of available locations can be obtained by calling ListLocations. For more information, see https://cloud.google.com/about/locations/. * `QUEUE_ID` can contain letters ([A-Za-z]), numbers ([0-9]), or hyphens (-). The maximum length is 100 characters. * `TASK_ID` can contain only letters ([A-Za-z]), numbers ([0-9]), hyphens (-), or underscores (_). The maximum length is 500 characters.

      • dispatchDeadlinestring

        The deadline for requests sent to the worker. If the worker does not respond by this deadline then the request is cancelled and the attempt is marked as a `DEADLINE_EXCEEDED` failure. Cloud Tasks will retry the task according to the RetryConfig. Note that when the request is cancelled, Cloud Tasks will stop listing for the response, but whether the worker stops processing depends on the worker. For example, if the worker is stuck, it may not react to cancelled requests. The default and maximum values depend on the type of request: * For App Engine tasks, 0 indicates that the request has the default deadline. The default deadline depends on the [scaling type](https://cloud.google.com/appengine/docs/standard/go/how-instances-are-managed#instance_scaling) of the service: 10 minutes for standard apps with automatic scaling, 24 hours for standard apps with manual and basic scaling, and 60 minutes for flex apps. If the request deadline is set, it must be in the interval [15 seconds, 24 hours 15 seconds]. Regardless of the task's `dispatch_deadline`, the app handler will not run for longer than than the service's timeout. We recommend setting the `dispatch_deadline` to at most a few seconds more than the app handler's timeout. For more information see [Timeouts](https://cloud.google.com/tasks/docs/creating-appengine-handlers#timeouts). `dispatch_deadline` will be truncated to the nearest millisecond. The deadline is an approximate deadline.

      • dispatchCountinteger

        Output only. The number of attempts dispatched. This count includes attempts which have been dispatched but haven't received a response.

      • firstAttemptobject

        Output only. The status of the task's first attempt. Only dispatch_time will be set. The other Attempt information is not retained by Cloud Tasks.

      • lastAttemptobject

        Output only. The status of the task's last attempt.

      • responseCountinteger

        Output only. The number of attempts which have received a response.

      • appEngineHttpRequestobject

        HTTP request that is sent to the App Engine app handler. An App Engine task is a task that has AppEngineHttpRequest set.

      • viewstring

        Output only. The view specifies which subset of the Task has been returned.

    • Update the specified task

      This action updates the specified task. This method supports patch semantics.

      PATCHTasksTasksPatch

      Request parameters

      • task*string

        Task identifier.

      • tasklist*string

        Task list identifier.

      Request body

      • completedstring

        Completion date of the task (as a RFC 3339 timestamp). This field is omitted if the task has not been completed.

      • deletedboolean

        Flag indicating whether the task has been deleted. The default if False.

      • duestring

        Due date of the task (as a RFC 3339 timestamp). Optional. The due date only records date information; the time portion of the timestamp is discarded when setting the due date. It isn't possible to read or write the time that a task is due via the API.

      • etagstring

        ETag of the resource.

      • hiddenboolean

        Flag indicating whether the task is hidden. This is the case if the task had been marked completed when the task list was last cleared. The default is False. This field is read-only.

      • idstring

        Task identifier.

      • kindstring

        Type of the resource. This is always "tasks#task".

      • linksarray

        Collection of links. This collection is read-only.

      • notesstring

        Notes describing the task. Optional.

      • parentstring

        Parent task identifier. This field is omitted if it is a top-level task. This field is read-only. Use the "move" method to move the task under a different parent or to the top level.

      • positionstring

        String indicating the position of the task among its sibling tasks under the same parent task or at the top level. If this string is greater than another task's corresponding position string according to lexicographical ordering, the task is positioned after the other task under the same parent task (or at the top level). This field is read-only. Use the "move" method to move the task to another position.

      • selfLinkstring

        URL pointing to this task. Used to retrieve, update, or delete this task.

      • statusstring

        Status of the task. This is either "needsAction" or "completed".

      • titlestring

        Title of the task.

      • updatedstring

        Last modification time of the task (as a RFC 3339 timestamp).

      • scheduleTimestring

        The time when the task is scheduled to be attempted or retried. `schedule_time` will be truncated to the nearest microsecond.

      • createTimestring

        Output only. The time that the task was created. `create_time` will be truncated to the nearest second.

      • namestring

        Optionally caller-specified in CreateTask. The task name. The task name must have the following format: `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID/tasks/TASK_ID` * `PROJECT_ID` can contain letters ([A-Za-z]), numbers ([0-9]), hyphens (-), colons (:), or periods (.). For more information, see [Identifying projects](https://cloud.google.com/resource-manager/docs/creating-managing-projects#identifying_projects) * `LOCATION_ID` is the canonical ID for the task's location. The list of available locations can be obtained by calling ListLocations. For more information, see https://cloud.google.com/about/locations/. * `QUEUE_ID` can contain letters ([A-Za-z]), numbers ([0-9]), or hyphens (-). The maximum length is 100 characters. * `TASK_ID` can contain only letters ([A-Za-z]), numbers ([0-9]), hyphens (-), or underscores (_). The maximum length is 500 characters.

      • dispatchDeadlinestring

        The deadline for requests sent to the worker. If the worker does not respond by this deadline then the request is cancelled and the attempt is marked as a `DEADLINE_EXCEEDED` failure. Cloud Tasks will retry the task according to the RetryConfig. Note that when the request is cancelled, Cloud Tasks will stop listing for the response, but whether the worker stops processing depends on the worker. For example, if the worker is stuck, it may not react to cancelled requests. The default and maximum values depend on the type of request: * For App Engine tasks, 0 indicates that the request has the default deadline. The default deadline depends on the [scaling type](https://cloud.google.com/appengine/docs/standard/go/how-instances-are-managed#instance_scaling) of the service: 10 minutes for standard apps with automatic scaling, 24 hours for standard apps with manual and basic scaling, and 60 minutes for flex apps. If the request deadline is set, it must be in the interval [15 seconds, 24 hours 15 seconds]. Regardless of the task's `dispatch_deadline`, the app handler will not run for longer than than the service's timeout. We recommend setting the `dispatch_deadline` to at most a few seconds more than the app handler's timeout. For more information see [Timeouts](https://cloud.google.com/tasks/docs/creating-appengine-handlers#timeouts). `dispatch_deadline` will be truncated to the nearest millisecond. The deadline is an approximate deadline.

      • dispatchCountinteger

        Output only. The number of attempts dispatched. This count includes attempts which have been dispatched but haven't received a response.

      • firstAttemptobject

        Output only. The status of the task's first attempt. Only dispatch_time will be set. The other Attempt information is not retained by Cloud Tasks.

      • lastAttemptobject

        Output only. The status of the task's last attempt.

      • responseCountinteger

        Output only. The number of attempts which have received a response.

      • appEngineHttpRequestobject

        HTTP request that is sent to the App Engine app handler. An App Engine task is a task that has AppEngineHttpRequest set.

      • viewstring

        Output only. The view specifies which subset of the Task has been returned.

    • Delete the specified task from the task list

      This action deletes the specified task from the task list.

      DELETETasksTasksDelete

      Request parameters

      • task*string

        Task identifier.

      • tasklist*string

        Task list identifier.