---
title: "Reopen a Task"
method: POST
path: "/task/reopen"
tags: ["tasks"]
---

# Reopen a Task

`POST /task/reopen`

This will reopen a completed or cancelled task.

## Request body

- TaskReopenParams
  - `object_type_id` integer, required
  - `ids` integer[], required
  - `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 reopened tasks

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

## Other responses

- `400` — Error reopening 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)