---
title: "Complete a set of Tasks"
method: POST
path: "/task/complete"
tags: ["tasks"]
---

# Complete a set of Tasks

`POST /task/complete`

This will mark one or many Tasks as complete. As an option, you can assign a new Task for further follow-up. To affect a single Task or list of specific Tasks, use the <strong>ids</strong> array in the <strong>criteria</strong> parameter. Otherwise, you should use <strong>performAll</strong> and other criteria to select a Group of Tasks to complete.

## Request body

- TaskCompleteParams
  - `object_type_id` integer, required
  - `ids` integer[], required
  - `group_id` integer — Group ID as an integer
  - `data` TaskData, required
    - `outcome` string — Task outcome name. This must start with ":=" For example, <strong>":=signed"</strong>.
    - `followup` TaskFollowup
      - `message_id` integer, required — Message ID of new Task to be created for further followup. This Task must currently exist. New tasks can be created using the <a href="https://api.ontraport.com/live/#!/objects/createObject">Objects Create endpoint</a> with objectID=1.
      - `due_date` integer, required — Due date of new Task, given as number of days from current date.
      - `task_owner` integer, required — New Task assignee.
    - `task_form_data` string — These fields can be used to update associated Object data when completing a task. For example, set <strong>task_form_title</strong> to "New title" to change the Contact's title.

## Response `200`

Successfully canceled tasks

- Response
  - `code` integer, required
  - `data` object, required
  - `account_id` integer, required

## Other responses

- `400` — Error completing tasks
- `403` — No permissions

---

[API](https://skmtc.net/ontraport/apis/ontraport-api.md) · [All operations](https://skmtc.net/ontraport/apis/ontraport-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ontraport/ontraport-api/revisions/edcd035d71f5/schema)